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ABSTRACT:  This  report,  the  second  in  a  series,  describes  upgrades  of  the  two-dimensional  circulation  model 
CMS-M2D  developed  under  the  Coastal  Inlets  Research  Program  (CIRP)  conducted  at  the  U.S.  Army  Engineer 
Rsearch  and  Development  Center,  Coastal  and  Hydraulics  Laboratory.  The  upgrades  chiefly  concern  capability  to 
calculate  sediment  transport  and  morphology  change  at  coastal  inlets,  navigation  channels,  and  adjacent  beaches. 
CMS-M2D  is  operated  as  part  of  the  CIRP’s  Coastal  Modeling  System  (CMS)  that  couples  calculations  of  wave 
transformation,  circulation  (horizontal  currents  and  water  surface  elevation),  sediment  transport,  and  morphology 
change.  The  coupling  is  interactive  and  accomplished  within  a  graphical  user  interface  called  the  Surface-water 
Modeling  System  (SMS).  Within  the  SMS,  the  CMS  contains  menus  and  steering  modules  that  allow  specification 
of  input  and  output,  as  well  as  the  time  steps  for  and  degree  of  interaction  among  the  various  processes.  The  SMS 
also  contains  utilities  for  viewing  data  and  calculation  results,  monitoring  progress  of  simulations,  and  running  of 
project  level  CMS-M2D  applications  with  tidal  and  surge  forcing  as  provided  by  a  regional  circulation  model. 

CMS-M2D  is  computationally  efficient,  easy  to  set  up,  and  has  features  required  for  many  coastal  engineering 
applications  at  coastal  inlets  and  at  the  bays  and  beaches  adjoining  inlets.  Example  features  include  robust  flooding 
and  drying,  wind-speed  dependent  (time-varying)  wind-drag  coefficient,  variably-spaced  bottom- friction  coefficient, 
time-  and  space-varying  wave-stress  forcing,  efficient  grid  storage  in  memory,  and  two  hot-start  options.  Three 
sediment-transport  formulations  are  available  for  selection  by  the  user,  two  involving  total  load  formulations  and 
one  involving  calculation  and  transport  by  bedload  and  suspended  load  in  an  advection-diffusion  equation  approach. 
Two  practical  morphologic  constraints  implemented  in  CMS-M2D  are  (1)  hard  bottom  (non-erodible  bottom)  to 
represent  limestone  and  rocking  coasts,  as  well  as  scour  blankets  at  jetties,  and  (2)  bottom  avalanching  to  limit 
channel  and  other  slopes  to  realistic  values.  The  model  has  been  applied  at  numerous  coastal  inlets  and  examined 
extensively  through  sensitivity  testing.  This  report  is  comprehensive  and  contains  information  on  the  hydrody¬ 
namic,  sediment  transport,  and  morphology  change  calculations,  descriptions  of  the  various  types  of  forcing  condi¬ 
tions  (waves,  wind,  tide,  river  flows)  boundary  conditions  that  can  be  represented,  operation  in  the  SMS,  and  exam¬ 
ples  of  input  files,  applications,  and  tests. 
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Preface 


The  tidal  and  nearshore  circulation  model  CMS-M2D  is  being  developed  in 
the  Coastal  Inlets  Research  Program  (CIRP)  as  part  of  the  Coastal  Modeling 
System  (CMS).  The  CMS  is  a  suite  of  coupled  models  operated  in  the  Surface- 
water  Modeling  System,  which  is  an  interactive  and  comprehensive  graphical 
user  interface  environment  for  preparing  model  input,  running  models,  and 
viewing  and  analyzing  results.  The  CIRP  is  administered  at  the  U.S.  Army 
Engineer  Research  and  Development  Center  (ERDC),  Coastal  and  Hydraulics 
Laboratory  (CHL)  under  the  Navigation  Systems  Program  for  Headquarters,  U.S. 
Army  Corps  of  Engineers  (HQUSACE).  Mr.  Barry  W.  Holliday  was  formerly 
HQUSACE  lead  technical  monitor  for  the  CIRP.  Dr.  Sandra  K.  Knight  and 
Mr.  James  E.  Clausner,  CHL,  are  the  Technical  Director  and  Associate  Director, 
respectively,  for  the  Navigation  Systems  Program.  Dr.  Nicholas  C.  Kraus,  Senior 
Scientists  Group  (SSG),  CHL,  is  the  CIRP  Program  Manager.  This  report  is  the 
second  in  a  series  on  CMS-M2D,  documenting  upgrades  to  the  circulation  model 
and  new  capabilities  to  calculate  sediment  transport  and  morphology  change  at 
coastal  inlets  and  adjacent  beaches  and  waterways. 

The  mission  of  the  CIRP  is  to  conduct  applied  research  to  improve  US  ACE 
capability  to  manage  federally  maintained  inlets,  which  are  present  on  all  coasts 
of  the  United  States,  including  the  Atlantic  Ocean,  Gulf  of  Mexico,  Pacific 
Ocean,  Great  Lakes,  and  U.S.  territories.  CIRP  objectives  are  to  advance 
knowledge  and  provide  quantitative  predictive  tools  to  (a)  make  management  of 
coastal  inlet  navigation  projects,  principally  the  design,  maintenance,  and 
operation  of  channels  and  jetties,  more  effective  and  reduce  the  cost  of  dredging, 
and  (b)  preserve  the  adjacent  beaches  in  a  systems  approach  that  treats  the  inlet 
and  beach  together.  To  achieve  these  objectives,  the  CIRP  is  organized  in  work 
units  conducting  research  and  development  in  hydrodynamic,  sediment  transport 
and  morphology  change  modeling;  navigation  channels  and  adjacent  beaches; 
inlet  structures  and  scour;  laboratory  and  field  investigations;  and  technology 
transfer. 

This  report  was  prepared  by  Dr.  Adele  Militello  Buttolph,  Coastal  Analysis 
LLC;  Dr.  Christopher  W.  Reed,  URS  Corporation;  Dr.  Kraus,  CHL; 

Dr.  Nobuyuki  Ono,  presently  at  ECOH  Corporation,  Tokyo,  Japan,  and  formerly 
at  Kyushu  University  and  guest  researcher,  CHL;  Drs.  Magnus  Larson,  Benoit 
Camenen,  and  Hans  Hanson,  Lund  University,  Sweden;  Mr.  Ty  Wamsley,  CHL, 
and  Dr.  Alan  K.  Zundel,  Environmental  Modeling  Research  Laboratory,  Brigham 
Young  University.  Dr.  Buttolph  was  Principal  Investigator  for  CMS-M2D  model 
development.  Dr.  Prank  S.  Buonaiuto,  State  University  of  New  York  at  Stony 
Brook,  Marine  Sciences  Research  Institute,  Mr.  Kenneth  J.  Connell,  Coastal 


Engineering  Branch,  CHL,  and  Mr.  Mitchell  E.  Brown,  SSG,  CHL,  contributed 
to  model  development  and  testing.  Work  was  performed  under  the  general 
administrative  supervision  of  Mr.  Thomas  W.  Richardson,  Director,  CHL,  and 
Dr.  William  D.  Martin,  Deputy  Director,  CHL. 

COL  Richard  B.  Jenkins  was  Commander  and  Executive  Director  of  ERDC. 
Dr.  James  R.  Houston  was  Director 


1  Introduction  to  CMS-M2D 


A  coastal  inlet  connects  an  ocean,  sea,  or  lake  through  a  typically  narrow 
landmass  to  the  water  body  behind  it,  such  as  a  bay,  estuary,  lagoon,  or  river. 
Hydrodynamic  forcing  contributing  to  the  water  exchange  that  maintains  the 
coastal  inlet  channel  may  be  the  tide,  river  flow,  wind,  or  seiching.  A  tidal  inlet 
is  the  most  common  type  of  coastal  inlet  and  is  the  waterway  connecting  the 
ocean  and  a  bay,  a  lagoon,  or  a  river  entrance  through  which  tidal  and  other 
currents,  such  as  from  rivers,  flow.  Longer  period  flows  at  coastal  inlets, 
nearshore  currents  produced  by  waves,  and  wave  action  move  sediment  at  many 
temporal  and  spatial  scales,  constrained  by  the  sea  bottom  morphology,  jetties, 
training  structures,  and  navigation  channel  dredging.  Change  in  morphology  at 
coastal  inlets  in  turn  modifies  the  incident  waves,  circulation,  and  sediment 
pathways.  Kraus  (2006)  gives  an  overview  of  morphologic  response  to  coastal 
inlets  and  to  engineering  actions  taken  at  inlets. 

Advances  in  numerical  modeling,  increased  speed  of  desktop  computers,  and 
reliable  and  powerful  interfaces  now  make  calculation  of  morphology  change  at 
coastal  inlets  feasible,  despite  the  large  number  of  interacting  processes. 
Simulation  of  morphology  change  at  inlets  is  an  emerging  area  of  applied 
research  of  interest  to  the  U.S.  Army  Corps  of  Engineers  (USACE)  and  its 
navigation  mission  at  coastal  inlets  in  design,  operation,  and  maintenance  of 
navigation  channels  and  jetties,  and  in  operating  coastal  inlets  within  the 
sediment-sharing  system  connecting  the  inlet,  adjacent  beaches,  and  bay. 

Because  of  the  wide  range  of  problems  to  be  addressed,  both  basic  and 
applied,  success  in  simulation  of  coastal  inlet  processes  is  promoted  by  exchange 
of  information  among  interdisciplinary  teams  of  coastal  engineers  and  scientists 
working  in  government,  private  industry,  and  academia.  A  system  approach  is 
required  that  is  based  on  a  comprehensive  numerical  model  with  a  code 
accessible  to  a  wide  range  of  researchers.  At  the  same  time,  the  model  should  be 
efficient  in  calculation  so  that  it  may  be  exercised  in  addressing  practical 
problems.  Experience  with  a  variety  of  coastal  inlets  and  engineering  problems 
will  call  for  continued  improvement  and  advances  in  model  capabilities. 

The  model  M2D  (Militello  et  al.  2004)  is  being  developed  under  the  Coastal 
Inlets  Research  Program  (CIRP)  conducted  at  the  U.S.  Army  Engineer  Research 
and  Development  Center  (ERDC),  Coastal  and  Hydraulics  Laboratory  (CHL)  as 
a  numerical  simulation  predictive  tool  with  which  to  support  multidisciplinary 
research  teams  and  conduct  practical  projects  at  coastal  inlets.  CMS-M2D  is  a 
component  of  the  CIRP’s  Coastal  Modeling  System  (CMS),  formerly  called  the 
Inlet  Modeling  System,  which  is  designed  to  calculate  combined  circulation 
(current  and  water-surface  elevation),  waves,  and  morphology  change  at  inlets 
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and  nearby  areas  and  operated  on  desktop  computers  through  operation  in  the 
Surfacewater  Modeling  System  (SMS)  interface  (Zundel  2000).  In  this 
interactive  environment,  CMS-M2D  can  simulate  hydrodynamics,  sediment 
transport,  and  morphology  change  at  project  level  at  coastal  inlets  and  the 
connecting  nearshore  and  bay.  CMS-M2D  is  computationally  efficient,  easy  to 
set  up,  and  incorporates  features  required  for  many  coastal  engineering 
applications.  CMS-M2D  can  be  coupled  to  regional  circulation  models,  such  as 
the  ADvanced  CIRCulation  (ADCIRC)  model  (Luettich  et  al.  1992),  through 
boundary  conditions  (Militello  and  Zundel  2002a,  2002b),  providing  flexibility 
for  larger  scale  applications  and  connectivity  between  models.  At  the  same  time, 
the  code  is  accessible  to  CIRP  researchers  with  expertise  in  areas  other  than 
computational  fluid  dynamics,  as  expected  in  interdisciplinary  teams. 

Prior  to  2005,  the  model  was  called  M2D.  Because  the  model  is  central  to 
the  CMS  in  terms  of  its  flexibility  and  functionality,  it  was  renamed  CMS-M2D 
in  2005.  In  this  report,  the  model  will  be  referred  to  as  M2D  or  CMS-M2D, 
depending  on  if  the  reference  is  to  the  model  prior  to  2005  or  to  the  present 
version. 

The  first  report  in  the  M2D  series  (Militello  et  al.  2004)  documented 
Version  2.0,  which  calculated  hydrodynamics  under  general  forcing  by  tide, 
waves,  and  wind.  The  present  report  describes  CMS-M2D  Version  3.0,  building 
upon  the  original  technical  documentation  and  describing  sediment  transport  and 
morphology  change  calculations,  other  model  advancements,  changes  to  input 
and  output  formats,  interface  modifications,  and  example  applications.  An  effort 
was  made  to  provide  a  complete  description  of  CMS-M2D  in  this  report  so  that  it 
is  self-contained  with  respect  to  both  the  hydrodynamics  and  morphology 
change. 

Scope  of  Model 

CMS-M2D,  Version  3.0,  is  a  finite-volume  numerical  representation  of  the 
two-dimensional  (2D)  depth-integrated  continuity  and  momentum  equations  of 
water  motion.  It  also  contains  integrated  representation  of  sediment  (presently, 
sand-sized  sediment)  transport  and  morphology  change  through  transport  rate 
formulations,  the  advection-diffusion  equation,  and  the  sediment  continuity 
equation  for  updating  change  in  the  sea  bottom.  Wave  forcing  is  included  in 
CMS-M2D  through  coupling  with  a  wave  model.  In  the  CMS,  radiation  stresses 
from  surface  waves  force  currents  and  change  the  water-surface  elevation  and,  if 
required,  the  calculated  current  can  be  input  to  the  wave  model  to  transform 
waves  propagating  on  it.  The  governing  equations,  finite-volume 
approximations,  representation  of  bottom  and  surface  stresses,  grid  scheme, 
boundary  conditions,  other  model  features,  and  graphical  interface  are  described 
in  this  report.  Examples  are  given  to  demonstrate  capabilities  of  CMS-M2D. 

Calculation  cells  in  CMS-M2D  are  defined  on  a  staggered,  rectilinear  grid 
and  can  have  constant  or  variable  side  lengths.  Momentum  equations  are  solved 
in  a  time-stepping  manner  first,  followed  by  solution  of  the  continuity  equation, 
in  which  the  updated  velocities  calculated  by  the  momentum  equations  are 
applied.  Optional  sediment  transport  calculations  are  conducted  on  updated 
velocity  and  water-surface  elevation  values,  together  with  wave  properties  if  they 
are  included  in  a  specific  simulation. 
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For  support  of  engineering  applications,  features  of  CMS-M2D  include 
flooding  and  drying,  wind-speed  dependent  (time-varying)  wind-drag  coefficient, 
variably  spaced  bottom- friction  coefficient,  wave-stress  forcing  that  can  vary  in 
space  and  time,  efficient  grid  storage  in  memory,  hot-start  options,  and  the 
convenience  of  independently  turning  on  or  off  the  advective  terms,  mixing 
terms,  wall  friction,  and  sediment  transport  and  morphology  change  calculations. 
Features  of  the  sediment  transport  component  include  three  transport  formulation 
options,  control  over  timing  of  transport  calculations  and  morphology  change 
calculations,  representation  of  hard  or  non-erodible  bottom,  and  representation  of 
avalanching  of  sea-bottom  slopes.  Additionally,  model  output  is  written  in 
formats  convenient  for  importing  into  commercially  available  plotting  packages. 
CMS-M2D  operates  exclusively  in  SI  units  and  requires  that  input  be  provided  in 
metric  units. 

CMS-M2D  has  been  designed  as  a  project-scale  model  that  can  be  easily  and 
quickly  applied  to  examine  engineering  issues  at  coastal  inlets  such  as  navigation 
channel  infilling,  natural  sand  bypassing,  consequences  of  mining  ebb-  or  flood- 
tidal  shoals,  and  changes  in  hydrodynamics  and  sediment  transport  in  response  to 
modifications  to  jetties.  The  model  has  been  developed  to  maximize  flexibility 
in  grid  specifications  and  forcing.  For  example,  if  forcing  by  water-surface 
elevation  time  series  is  prescribed  as  a  boundary  condition,  the  time  interval 
between  values  in  the  time  series  does  not  have  to  be  constant.  Thus,  if  values 
were  being  supplied  from  a  water-level  gauge  and  the  sampling  rate  was 
modified,  the  measurements  could  be  prescribed  as  forcing  without  sub-sampling 
the  data  set. 

Implementation  within  Surface-Water  Modeling 
System 

A  graphical  interface  for  CMS-M2D  is  implemented  within  the  SMS, 
Versions  8.1  and  higher  (Zundel  2000).  Features  of  the  CMS-M2D  interface 
cover  grid  development,  control  file  specification,  boundary  condition  and  wind 
specification,  coupling  with  regional  and  wave  models,  model  runs,  post¬ 
processing  of  results,  and  input  and  output  visualization.  The  SMS  provides 
flexibility  in  grid  generation  and  modification  by  incorporating  model-specific 
tools  to  assign  bathymetric  data  sets  for  interpolating  to  the  CMS-M2D  grid, 
manually  modifying  depths  and  friction  coefficients,  adjusting  cell  sizes,  and 
inserting  or  deleting  calculation  cells.  Variably  spaced  grids  can  be  readily 
developed  with  SMS  tools  that  spatially  scale  the  cell  sizes  over  user-defined 
extents.  The  SMS  contains  dialogs  for  specification  of  boundary  conditions.  For 
some  boundary  types,  forcing  information  can  be  input  manually  from  within  the 
SMS,  or  predefined  information  can  be  read  from  files.  A  model  control  dialog 
provides  the  user  with  a  convenient  interface  for  specifying  timing  control,  model 
options,  wind  and  wave  forcing,  sediment  transport  and  morphology  change 
options,  and  output  options. 

CMS-M2D  can  be  driven  by  larger-domain  circulation  models,  such  as 
ADCIRC,  through  boundary  specification  capabilities  contained  within  the  SMS. 
The  boundary  conditions  dialog  allows  access  to  solutions  from  larger-domain 
models  that  can  be  extracted  and  mapped  to  CMS-M2D  boundaries.  The  user 
can  decide  whether  to  specify  water-surface  elevation  or  a  combination  of  water- 
surface  elevation  and  velocity  as  boundary  input  for  CMS-M2D.  This  capability 
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provides  CMS-M2D  with  boundary  conditions  that  preserve  tidal  phase  and  other 
variations  calculated  by  a  larger  or  regional  scale  model. 

The  SMS  also  allows  automated  coupling  of  CMS-M2D  with  the  STeady 
state  spectral  WAVE  model  STWAVE  (Smith  et  al.  1999,  2001)  and  the  Wave 
Action  Balance  Equation  with  Diffraction  (WABED)  model  (Mase  2001;  Mase 
and  Kitano  2000;  Mase  et  al.  2005)  through  a  Steering  Module  dialog,  which  is 
convenient  for  projects  that  require  wave-stress  forcing  for  CMS-M2D.  The 
Steering  Module  allows  the  user  to  control  the  model  coupling,  giving  flexibility 
in  conducting  simulations  of  wave-driven  currents  and  the  wave-current 
interaction. 

Sediment  transport  and  morphology  change  options  are  specified  within  the 
SMS  model  control  dialog  for  CMS-M2D.  This  dialog  allows  the  user  to  select 
from  three  sediment  transport  formulations  and  enter  formulation-specific 
parameters.  Timing  controls  for  sediment  transport  rate  calculations  and  for 
morphology  change  are  included  in  the  dialog. 

Studies  Performed  with  CMS-M2D 

CMS-M2D  has  been  developed  and  tested  in  basic  and  applied  studies 
covering  a  wide  range  of  bathymetric  configurations,  forcing,  and  project  goals. 
Summaries  of  selected  applications  are  described  here  to  familiarize  users  with 
model  capabilities  and  to  establish  model  history. 

M2D  was  first  applied  to  investigate  hydrodynamic  responses  to  proposed 
engineering  projects  on  the  Texas  coast.  Inlet  and  bay  hydrodynamics  on  this 
coast  are  frequently  dominated  by  wind  forcing,  making  this  region  a  more 
complex  study  area  than  most  inlet  and  bay  systems  on  the  Atlantic  and  Pacific 
Ocean  coasts  of  the  United  States.  Changes  in  circulation  patterns  in  the  Upper 
Laguna  Madre  and  exchange  of  water  with  the  Gulf  of  Mexico  were  calculated 
for  proposed  causeway  modifications  designed  to  improve  evacuation  safety 
(Brown,  Militello,  and  Kraus  1995a,  1995b,  1995c)  for  the  Kennedy  Causeway 
that  connects  North  Padre  Island  with  the  mainland.  As  a  result  of  the  analysis, 
the  Kennedy  Causeway  was  elevated  to  provide  improved  circulation  to  the 
Laguna  Madre  and  a  more  reliable  evacuation  route  from  North  Padre  Island. 

In  an  investigation  of  a  proposed  new  inlet  called  the  Southwest  Comer  Cut 
that  would  connect  East  Matagorda  Bay  to  the  Colorado  River  Navigation 
Channel,  TX,  M2D  was  applied  to  calculate  water  velocity  changes  in  the 
navigation  channel  and  Gulf  Intracoastal  Waterway  and  to  determine  whether  the 
new  inlet  would  promote  closure  of  Mitchell’s  Cut  (Kraus  and  Militello  1996, 
1999;  Militello  and  Kraus  1998)  an  inlet  and  flood  relief  channel  located  on  the 
opposite  end  of  East  Matagorda  Bay. 

In  a  basic  study  of  the  hydrodynamics  of  Baffin  Bay,  TX,  M2D  was  applied 
to  calculate  the  wind-driven  circulation  and  set  up  and  set  down  in  this  nontidal 
bay  (Militello  1998,  2000).  Model  calculations  also  determined  the  contributions 
of  nonlinear  terms  in  the  governing  equations  to  harmonics  of  the  oscillatory 
wind  (sea  breeze)  forcing  in  Baffin  Bay  (Militello  1998;  Militello  and  Kraus 
2001). 

In  a  channel  infilling  study  for  Bay  Center,  a  harbor  located  inside  Willapa 
Bay,  WA  (Kraus,  Arden,  and  Simpson  2000),  M2D  calculated  current  velocity 
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over  a  1 -month  time  interval  from  which  bed  elevation  changes  were  computed 
(Militello  2002;  Militello  et  al.  2003).  The  Bay  Center  application  also 
demonstrated  successful  coupling  of  M2D  with  ADCIRC.  This  success, 
combined  with  CIRP  goals,  led  to  the  development  of  automated  M2D  and 
ADCIRC  (or  other  larger-domain  model)  coupling  capability  within  the  SMS 
(Militello  and  Zundel  2002a,  2002b). 

As  part  of  the  CIRP’s  efforts  to  assure  model  reliability,  M2D  calculated  tide 
and  wave-driven  currents  at  an  idealized  inlet  and  ebb  shoal  for  fair  weather  and 
storm  waves  (Militello  and  Kraus  2003).  Interactions  between  wave-driven 
currents  and  the  ebb  jet  varied,  depending  on  the  relative  strength  of  the  two 
current  sources.  For  storm  waves,  calculated  alongshore  velocities  were  stronger 
and  the  surf  zone  was  wider  and  farther  from  shore,  as  compared  to  the  fair- 
weather  waves.  This  study  demonstrated  coupling  of  M2D  and  a  surface  wave 
model  (STWAVE),  described  in  this  volume  and  by  Militello  and  Zundel  (2003), 
and  the  capability  to  calculate  sediment  transport  and  morphology  change  that 
has  since  been  advanced. 

Recent  applications  include  calculation  of  hydrodynamics  and  morphology 
change  under  combined  tide  and  wave  forcing  at  Shinnecock  Inlet,  NY 
(Bounaiuto  and  Militello  2004)  and  at  the  mouth  of  the  Colorado  River,  TX  (Lin, 
Kraus,  and  Barcak  2004).  The  study  at  Shinnecock  Inlet  compared  measured 
change  in  bathymetry  at  the  inlet  and  ebb  shoal  with  calculations  representing  the 
same  6-month  time  frame  (13  August  1997  to  28  May  1998).  Observed  major 
changes  in  morphology  were  shown  to  be  represented  by  the  model,  including 
westward  migration  of  the  channel  thalweg,  scour  of  the  inlet  throat,  and 
accretion  of  the  ebb  shoal.  For  the  Colorado  River  study,  six  structural 
alternatives  were  evaluated  for  performance  relating  to  sediment  management  at 
the  inlet  (river  mouth)  entrance.  For  the  existing  condition,  M2D  was 
demonstrated  to  reproduce  sediment  shoaling  at  the  entrance  and  filling  of  a 
deposition  basin  located  adjacent  to  a  weir  jetty. 

Report  Contents 

This  report  describes  Version  3.0  of  CMS-M2D  and  gives  instruction  on 
development  of  a  CMS-M2D  project  within  the  SMS.  Chapter  2  covers  the 
governing  equations  for  water  motion  that  are  solved  in  the  model.  Chapter  3 
similarly  covers  the  governing  equations  for  sediment  motion  and  morphology 
change,  as  well  as  methods  describing  morphologic  constraints  that  have  been 
implemented  in  CMS-M2D.  Chapter  4  describes  the  numerical  approximations 
for  water  motion  and  defines  the  cell  numbering  method,  and  Chapter  5  describes 
the  numerical  approximations  for  sediment  motion  and  morphology  change. 
Chapter  6  reviews  the  types  of  boundary  conditions  available  in  CMS-M2D. 
Chapter  7  describes  key  model  features,  and  Chapter  8  reviews  the  SMS  interface 
for  CMS-M2D  and  provides  guidance  for  project  development.  Chapter  9 
provides  information  on  model  setup  and  file  structure.  Chapter  10  provides 
example  applications  of  CMS-M2D. 

Appendices  supplement  the  main  text  and  contain  more  detailed  and 
auxiliary  information.  Appendix  A  gives  example  input  and  output  files. 
Appendix  B  provides  references  for  CMS-M2D  development  and  applications. 
Appendices  C  through  F  describe  results  of  numerical  model  integrity  tests. 
Appendix  G  demonstrates  the  wave-adjusted  boundary  condition,  which  modifies 
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prescribed  boundary  condition  values  for  the  presence  of  wave  forcing. 
Appendix  H  compares  calculated  and  measured  longshore  currents  from 
laboratory  experiments.  Appendix  I  demonstrates  the  capability  for 
representation  of  hard  bottom  (non-erodible  bottom). 


6 


Chapter  1  Introduction  to  M2D 


2  Governing  Equations  for 
Water  Motion 


CMS-M2D  solves  the  2D,  depth-integrated  continuity  and  momentum 
equations  by  applying  a  finite- volume  method.  Velocity  components  are 
calculated  in  two  horizontal  dimensions.  This  chapter  introduces  the  governing 
equations  and  describes  the  respective  terms  and  variables.  Wind  and  bottom 
stress  formulations  are  presented,  as  well  as  implementation  of  wave  stresses. 

The  2D  depth-integrated  continuity  and  momentum  equations  solved  by 
CMS-M2D  are: 

i)+^+j^=0  (1) 

dt  dx  dy 

,  dv<lx  ,  1  djh  +  yf  _  d  D  &L 

dt  dx  dy  2  dx  dx  dx  dy  '  dy  (2) 

+  f<ly-Xbx+Xwx+XSx 

dqy  duqy  dvqy  \  d(h  +  T|)2  d  ^  dqy  3  dq 

dt  dx  dy  2  dy  dx  dx  dy  y  dy  (3) 

-fay  ~\y  +Twy  +TSy 

where 

h  =  still- water  depth  relative  to  a  specific  vertical  datum 
T|  =  deviation  of  the  water-surface  elevation  from  the  still-water  level 
t  =  time 

qx  =  flow  per  unit  width  parallel  to  the  x-axis 
qy  =  flow  per  unit  width  parallel  to  the  y-axis 
u  =  depth-averaged  current  velocity  parallel  to  the  x-axis 
v  =  depth-averaged  current  velocity  parallel  to  the  y-axis 
g  =  acceleration  due  to  gravity 
Dx  =  diffusion  coefficient  for  the  x  direction 
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Dy  =  diffusion  coefficient  for  the  y  direction 
/  =  Coriolis  parameter 
Tbx  =  bottom  stress  parallel  to  the  x-axis 

Tby  =  bottom  stress  parallel  to  the  y-axis 
Twx  =  surface  stress  parallel  to  the  x-axis 
Twy  =  surface  stress  parallel  to  the  y-axis 
XSx  =  wave  stress  parallel  to  the  x-axis 
T Sy  =  wave  stress  parallel  to  the  y-axis 

Component  velocities  are  related  to  the  flow  rate  per  unit  width  as: 


u  = 


qx 

h  +  x i 


v  = 


h  +  x i 


(4) 

(5) 


For  the  situation  without  waves,  bottom  stresses  are  given  by: 

Vc=c>M  (6) 

\=Cbv\U\  (7) 

where  U=  total  current  speed  and  Cb  =  empirical  bottom-stress  coefficient.  The 
total  current  speed  is: 


|t/|  =  Vm2+v2 

The  bottom-friction  coefficient  is  calculated  by: 


where  C  =  Chezy  coefficient  given  by: 


(8) 

(9) 


D  1/6 

C  = -  (10) 

n 

in  which  R  =  hydraulic  radius,  and  n  =  Manning  roughness  coefficient. 

In  the  presence  of  waves,  the  bottom  stress  contains  contributions  from  both 
the  quasi-steady  current  (as  from  tide,  wind,  and  surface  waves)  and  the  bottom 
orbital  motion  of  the  waves.  Assessment  of  an  average  bottom  stress  over  the 
period  of  a  surface  wave,  which  requires  numerical  integration,  would  need  to  be 
performed  at  every  grid  point  at  every  time  step,  a  computation-intensive 


8 


Chapter  2  Governing  Equations  for  Water  Motion 


operation.  Instead,  here  a  square  wave  approximation  for  the  wave  is  applied, 
which  allows  analytic  estimation  of  the  time  average.  It  is  given  by  the  following 
approximation  for  the  time-averaged  bottom  stress  under  combined  currents  and 
waves  (Nishimura  1988): 


*fa  =  Q- 


\=cb- 


T  T  2 

U . 4 — —cos  a 


U 


u  + 


(  0)? 
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KU*c 


-cos  a  sin  a 


(11) 
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-cos  a  sin  a 
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u  + 


U  +-°^  ~-2 


u„ 


sin  a 


(12) 


j  v 

in  which  a  =  wave  angle  relative  to  the  x-axis,  and  Uwc  and  CO^  are  given  by: 


Uwc  =  +v2  +  co2  +  2(wcosa  +  vsina)o\| 

+  ^|i/2  +  v2  +  cojj  —2  (u  cos  oc  +  vsin  oc)  co^  || 


(13) 


cH 


7isinh[£(/z  +  r|)] 

where  a  =  wave  angular  frequency,  H  =  wave  height,  and  k  =  wave  number. 


(14) 


Surface  wind  stresses  are  given  by: 


in(8) 

PW 

(15) 

cos(e) 

P  w 

(16) 

where 

n 

d  =  wind  drag  coefficient 
pa  =  density  of  air 

Pu.  =  density  of  water 
W  wind  speed 
0  =  wind  direction 

The  convention  for  wind  direction  is  specified  to  be  0  deg  for  wind  from  the  east 
with  angle  increasing  counterclockwise. 
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Wave  stresses  are  calculated  from  spatial  gradients  in  radiation  stresses  as: 


X 


Sx 


dx 


+ 


dS  ^ 

xy 

dy  , 


(17) 


x 


05 


xy 


dx 


+  - 


dy 


(18) 


where  Sxx,  Sxy,  and  Syy  are  wave-driven  radiation  stresses.  Radiation-stress  tensor 
calculations  are  based  on  linear  wave  theory  and  computed  within  STWAVE, 
WABED,  or  other  wave  model  for  supplying  information  to  CMS-M2D.  They 
represent  the  summation  of  standard  tensor  formulations  across  the  defined 
spectrum.  For  a  coordinate  system  with  the  x-axis  oriented  normal  to  the 
shoreline,  the  tensor  components  are  (Smith  et  al.  2001): 


||  5(a),  a) 

0.5 

f  |  2k(h+x\)  " 

(cos2  a  +  l)-  0.5 

sinh2A:(/*+r|)^ 

V  / 

s-=jj 


5(go,  a) 


0.5 


n  2k{h+r\) 

sinh  2£(/z  +  r|)y 


sin  2a 


dtoda 


f  f5(co,  a) 

0.5 

f  |  2k(h+y\)  \ 

(sin2  a  +  l)-  0.5 

J  J  v  ’  > 

sinh2A:(/2+r|)^ 

V  / 

dwda  (19) 


(20) 


dwda  (21) 


where 


Sxx  =  flux  of  shore-normal  momentum 

Sxy  =  of  shore -parallel  momentum,  or  the  shear  component  of  the  radiation 
stress 


Syy  =  flux  of  momentum  alongshore 
E  =  wave  energy  density 

Wave  models  such  as  STWAVE  typically  calculate  in  coordinate  systems 
such  that  the  x-axis  is  normal  to  the  shoreline  (positive  x  directed  toward  shore) 
and  the  y-axis  is  parallel  to  the  shoreline.  For  CMS-M2D  applications,  the 
radiation-stress  tensor  is  rotated  from  the  STWAVE  grid  and  mapped  onto  the 
CMS-M2D  grid  by  the  SMS. 


The  Coriolis  parameter  is  given  by: 

/  =  2Qsin(^>)  (22) 


where  Q  =  angular  frequency  of  the  Earth's  rotation,  and  cp  =  latitude. 


The  depth-mean  horizontal  eddy  viscosity  coefficient  D  depends  on  the 
strength  of  mixing  in  the  water  column,  which  is  a  function  of  the  acting 
processes  at  a  particular  location.  If  waves  do  not  contribute  significantly  to 
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mixing,  D  can  be  calculated  as  a  function  of  the  total  water  depth,  current  speed, 
and  bottom  roughness  as  (Falconer  1980): 


1.156g(/z  +  T|) 


(23) 


where  the  subscript  o  denotes  oceanic  mixing.  The  form  of  the  eddy  viscosity 
coefficient  given  by  Equation  23  produces  a  mixing  term  that  is  weakly 
nonlinear. 


In  the  surf  zone,  waves  contribute  significantly  to  lateral  mixing,  and  the 
eddy  viscosity  coefficient  is  expected  to  be  a  function  of  the  wave  properties.  In 
CMS-M2D,  surf  zone  mixing  is  represented  by: 

Dw=£l  (24) 

where  EL  describes  the  lateral  mixing  below  trough  level  (Smith,  Larson,  and 
Kraus  1993)  and  is  expressed  as  (Kraus  and  Larson  1991): 

e£=A  umH  (25) 

where  A  =  empirical  coefficient  representing  the  lateral  mixing  strength,  and 
um  =  amplitude  of  the  horizontal  component  of  the  wave  orbital  velocity  at  the 
bottom  given  by: 


= 


gHT 


2\  cosh 


27i(/z  +  r|) 


(26) 


where  T  wave  period. 

Mixing  is  a  vigorous  three-dimensional  (3D)  process  in  the  surf  zone  not 
readily  represented  in  a  depth-averaged  model.  Such  vertical  processes  cannot  be 
directly  described  in  a  depth-average  model,  and  the  mixing  coefficient  in 
Equation  25  should  be  considered  as  a  surrogate.  Streaming  from  undertow 
advects  turbulent  eddies  or  mixing  offshore,  and  this  mixing  can  support  a  strong 
current  seaward  of  the  wave  breakpoint  (Putrevu  and  Svendsen  1992).  With 
further  distance  seaward,  the  vertical  current  decreases  as  the  volume  of  water 
increases,  weakening  the  mixing  and  the  longshore  current. 

The  transition  between  surf  zone  mixing  and  oceanic  mixing  seaward  of  the 
breakpoint  is  represented  in  CMS-M2D  by  a  weighted  mixing  coefficient 
specified  as: 

£>  =  (1-9  )D  +0  D  (27) 

where  the  weighting  parameter  0w  is  given  by: 
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( 


H 


(28) 


0 . = 


A3 


\h+r \y 


The  method  of  weighting  and  the  weighting  parameter  are  ad  hoc  and  must 
be  validated  by  comparison  to  data.  Intuitively,  a  cubic  dependence  on  water 
depth  introduces  the  fluid  volume. 

To  illustrate  the  control  on  the  cross-shore  distribution  of  the  longshore 
current  by  wave  friction  and  representation  of  mixing,  four  simulations  were 
conducted  that  correspond  to  Visser  (1982)  Case  4.  The  Visser  laboratory  data 
and  CMS-M2D  grid  and  parameter  values  are  described  in  Appendix  H  with  one 
difference  being  that  the  Manning’s  n  value  for  velocities  discussed  in  this 
section  was  0.013.  The  four  simulations  consisted  of  combinations  of  wave 
friction  specification  and  mixing  coefficient.  Simulations  denoted  as  “No  Wave 
Friction”  did  not  include  waves  as  a  source  of  friction,  whereas  “Wave  Friction” 
denoted  the  bottom  stress  as  defined  by  Equations  1 1  and  12.  Mixing 
coefficients  were  calculated  as  “Wave  Mixing,”  which  indicated  application  of 
Equation  24,  and  “Weighted  Mixing,”  which  denoted  the  combined  oceanic  and 
surf  zone  mixing  described  by  Equation  27. 

Calculated  and  measured  longshore  current  for  Visser  Case  4  are  compared 
in  Figure  1.  Values  of  distance  increase  toward  the  offshore  direction.  Peak 
calculated  current  speed  varies  between  0.37  and  0.40  m/s  and  measured  peak 
speed  is  0.39  m/s.  Thus,  combinations  of  both  wave  friction  and  representation 
of  the  mixing  coefficient  exert  control  on  the  maximum  current  speed.  Greatest 
variation  among  the  calculated  speeds  is  located  between  the  peak  current  and  the 
weakening  current  with  distance  offshore.  Calculation  with  the  weighted  mixing 
coefficient  and  wave  friction  produced  a  curve  in  which  the  magnitude  and  slope 
compare  well  with  measurements.  All  remaining  calculations  show  deviation  in 
magnitude  and  curvature  from  measured  values  in  the  offshore  tail. 

Accurate  estimation  of  the  wind-stress  coefficient  is  necessary  for  calculating 
wind-induced  flow  in  shallow  water  (depths  ~<  5  m).  A  short  review  describing 
the  development  of  the  variable  wind-stress  coefficient  implemented  in  CMS- 
M2D  is  presented  here. 
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Figure  1 .  Comparison  of  longshore  current  speed  values  for  Visser  Case  4 

The  flux  of  momentum  into  the  water  column  from  the  wind  is  specified  as  a 
function  of  the  wind  speed  and  wind-stress  coefficient.  Anemometer  height 
above  the  water  or  land  surface  must  be  considered  for  accurate  estimation  of  the 
wind-stress  coefficient  because  wind  speed  varies  logarithmically  in  the  vertical 
direction  for  unstratified  atmospheric  conditions.  A  general  law  for  the  vertical 
wind  profile  is  given  by  (Charnock  1955;  Hsu  1988): 

W  7 

Wz=  —  In—  (29) 

K  Z0 

where 

Wz  =  wind  speed  at  height  Z  above  the  surface 
Z0  =  surface  roughness 
W*  =  friction  velocity 
K  =  von  Karman  constant 

The  friction  velocity  is  defined  in  terms  of  the  surface  wind  stress  T0  as  (Hsu 
1988): 

2  dW 

\=VaW?=VaKm—  (30) 

where  Km  =  eddy  viscosity  coefficient,  and  z  is  the  vertical  dimension. 

Under  the  assumption  of  nearly  neutral  atmospheric  stability,  the  wind-stress 
coefficient  over  water  at  a  height  10  m  above  the  water  surface,  Ci0,  can  be 
expressed  as  (Hsu  1988): 
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(31) 


where  W\0  =  wind  speed  in  meters  per  second  at  10  m  above  the  surface. 
Equation  31  includes  the  assumption  of  fully  developed  seas.  For  measurements 
of  wind  speed  made  at  heights  other  than  10  m,  an  approximation  for  the  10-m 
wind  speed  is  ( Shore  Protection  Manual  1984): 


(32) 


The  surface  wind-stress  Equations  15  and  16,  as  implemented  in  CMS-M2D, 
apply  the  10-m  wind-drag  coefficient  and  wind  speed  to  compute  the  surface 
stress.  Thus,  values  of  C\0  and  W10  defined  by  Equations  31  and  32  are  specified 
as  Cd  and  W  in  Equations  15  and  16. 

Equations  31  and  32  have  been  successfully  applied  in  modeling  studies 
investigating  motion  in  strong  wind-forced  shallow  embayments  with  typical 
depths  ranging  from  1  to  4  m  (Brown,  Militello,  and  Kraus  1995a;  Kraus  and 
Militello  1999;  Militello  2000).  Calculated  water  level  and  current  compared 
well  with  measurements,  indicating  that  these  formulations  are  satisfactory  for 
estimation  of  the  vertical  wind  profile  and  wind  stress  in  shallow- water  systems. 
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3  Governing  Equations  for 
Sediment  Motion  and 
Methods  for  Morphologic 
Constraints 


As  a  user-specified  option,  CMS-M2D  calculates  sediment  transport  rates 
and  resultant  changes  in  water  depth  (bottom  elevation)  through  gradients  in  the 
transport  rates.  In  CMS-M2D  Version  3,  three  transport  rate  formulations  are 
available: 

a.  Watanabe  (1987)  total  load  formulation. 

b.  Lund-CIRP  (Camenen  and  Larson  2005,  2006)  total  load  formulation 
(combined  suspended  and  bed  load). 

c.  Advection-diffusion  (AD)  transport  for  suspended  load  coupled  with  either 
the  van  Rijn  (1998)  or  the  Lund-CIRP  formulation  for  bed  load.  The  AD 
equation  applies  the  reference  concentration  and  sediment  diffusivity  from 
either  the  van  Rijn  or  Lund-CIRP  formulation  as  a  user  option. 

The  sediment  transport  formulas  are  applicable  with  or  without  the  presence 
of  waves.  Change  in  bottom  elevation  is  calculated  by  the  sediment  continuity 
equation  in  which  transport  rates  computed  from  a  specified  formulation  are 
entered.  The  Lund-CIRP  formulas  have  the  properties  of  smooth  transitions 
between  areas  of  breaking  and  non-breaking  waves  and  between  areas  of 
transport  by  current  only  and  by  a  current  and  waves. 

CMS-M2D  accounts  for  the  two  morphologic  constraints  of:  (a)  hard  bottom 
(non-erodible  substrate)  and  (b)  bottom  avalanching  if  the  slope  exceeds  a 
specified  value.  The  approach  taken  to  treat  hard  bottom  allows  for  sand  to 
accumulate  over  the  hard  bottom  if  depositional  conditions  are  present,  and  it 
also  allows  material  overlying  the  hard  substrate  to  erode  while  preserving 
sediment  volume.  Avalanching  is  invoked  if  the  bottom  slope  between  two  cells 
exceeds  a  specified  critical  slope.  The  avalanching  algorithm  applies  an  iterative 
approach  to  move  material  down  slope  until  the  critical  slope  is  no  longer 
exceeded,  while  conserving  sediment  volume. 

The  transport  rate  formulas  that  can  be  applied  in  CMS-M2D  Version  3  are 
based  on  the  shear  stress  concept,  implying  that  bed  roughness  and  resulting 
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friction  factors  are  key  parameters  to  estimate  when  computing  transport  rates.  A 
sediment  transport  formula  is  often  developed  (i.e.,  calibrated  against  data)  based 
on  specific  equations  for  calculating  bed  roughness  and  associated  shear  stress. 
Thus,  when  calculating  the  transport  rate  in  CMS-M2D  with  the  three 
implemented  formulas,  slightly  different  approaches  are  taken  to  determine  the 
shear  stress.  In  the  following  sections,  the  methods  are  discussed  for  obtaining 
the  shear  stress  for  each  of  the  sediment  transport  formulas.  Also,  it  is  noted  that 
the  roughness  and  associated  shear  stresses  within  the  sediment  transport 
calculations  are  different  from  those  in  the  CMS-M2D  hydrodynamic 
calculations.  The  computed  current  field  and  properties  of  surface  waves 
calculated  from  a  separate  model  are  input  to  the  roughness  and  shear  stress 
calculations  for  the  sediment  transport,  but  there  is  presently  no  feedback  of 
roughness  or  shear  stress  from  the  sediment  transport  component  of  the  model  to 
the  hydrodynamic  or  wave  calculations. 

CMS-M2D  calculates  the  current  velocity  in  two  horizontal  coordinate 
directions  (w,  v).  If  there  is  negligible  contribution  from  the  waves  to  the 
transporting  velocity  (e.g.,  sinusoidal  waves),  the  net  transport  is  in  the  direction 

of  the  resulting  current  vector  and  has  magnitude  of  U c  —  \ \u 2  +  v2  .  Thus, 

waves  will  contribute  to  the  mobilization  and  stirring  of  sediment,  but  a  mean 
current  is  needed  to  produce  a  net  transport.  The  Watanabe  total  load 
formulation  and  the  AD  equation  compute  sediment  transport  rates  along  the  x 
and  y  axes.  The  Lund-CIRP  total  load  formula  computes  transport  in  the 
direction  of  the  current.  In  order  to  obtain  the  Lund-CIRP  calculated  transport  in 
the  two  horizontal  coordinate  directions,  the  transport  vector  is  split  up  into  x- 
and  y-directed  components. 

The  following  sections  describe  the  sediment  transport  equations  applied  in 
CMS-M2D,  followed  by  the  methodologies  implemented  to  treat  hard  bottom 
and  avalanching. 


Watanabe  Formulation 

The  total  load  sediment  transport  rate  of  Watanabe  (1987)  is  given  by: 

(x,  -x  )£/ 

\  b, max  cr  )  c 


<1,0,  =  A 
where 


Pwg 


(33) 


qtot  =  total  load  (both  suspended  and  bed  load) 
Tb  max  =  maximum  shear  stress  at  the  bed 

T cr  =  shear  stress  at  incipient  sediment  motion 
U c  =  depth  averaged  current  velocity 
pw  =  density  of  water 
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g  =  acceleration  of  gravity 

A  =  empirical  coefficient  typically  ranging  from  0.1  to  2 
The  shear  stress  at  incipient  motion  is: 

V  =  (p,-pJg4A,  (34) 

where 

=  sediment  density 
d50  =  median  grain  diameter 
0cr  =  critical  Shields  parameter 

For  the  case  of  currents  only  (no  waves)  the  bed  shear  stress  Tc  is: 
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The  wave  friction  factor  is  (Nielsen  1992): 

5.5(iTa2)-6.3 

/  —e  v  ’ 

J  w 

where  R  is  the  relative  roughness  defined  as: 

R  =  A 

Kd 

where  A„  is  the  semi-orbital  excursion  defined  as: 

UT 


A=- 


2k 


(41) 


(42) 


(43) 


Transport  rates  are  set  to  zero  at  the  beginning  of  the  simulation,  then 
updated  at  each  sediment  transport  time  step. 


Lund-CIRP  Formulation 

The  Lund-CIRP  formulation  is  implemented  into  CMS-M2D  in  two  modes. 
One  mode  is  calculation  of  total  load  through  combining  bed  load  and  suspended 
load  transport.  The  second  mode  is  implementation  in  the  AD  transport  equation. 
Bed  roughness  and  friction  factors  applied  in  the  Lund-CIRP  formulation  are  first 
introduced,  followed  by  descriptions  of  the  bed  load  and  suspended  load 
formulations,  respectively. 

Bed  roughness  and  friction  factors 

Bottom  roughness  ks  is  assumed  to  consist  of  three  components,  namely  grain 
related  roughness  ksd ,  form-drag  roughness  ksj,  and  sediment-related  roughness  kss 
(Soulsby  1997).  Total  roughness  is  obtained  as  the  linear  sum  of  these 
components: 

K  =  Kd  +  Kf  +  Ks  (44) 

where  the  grain-related  roughness  is  given  by  Equation  37. 

Form-drag  roughness  is  primarily  a  function  of  the  ripple  properties  and 
calculated  as  (Soulsby  1997): 

Kf=  7-5^  (45) 

Lr 

in  which  Hr  =  ripple  height,  and  Lr  =  ripple  length,  which  are  computed  from: 


L  =100(kL 


H,=  — 

7 


for  a  current  (Soulsby  1997)  and  from: 


(46) 
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Vw<10 


Hr  =  0.22  Aw 
4=1-25  Aw 

Hr  =2.8  10“13(250-\|/m,)5^m, 

4  =  1  -4  •  10-6  (250  -  Vw  f 5  4  10  <  Vw  <  250 


4=0 

4=°  > 250 

for  waves  (van  Rijn  1993),  where  i|f ,  =  mobility  parameter  that  is  defined  by: 


ui 


4-1  )gdso 

and  5  =  specific  density  given  by: 


(48) 


Pw 

The  sediment-related  roughness  is  given  by  Wilson  (1966,  1989): 


(49) 


K  =  5c4>0,  (5°) 

where  0.  =  Shields  parameter  for  current  or  waves  (i  =  c ,  w,  respectively,  for 
current  and  waves).  Expressions  for  the  Shields  parameter  for  currents  0c  and 
for  waves  0w  are  given  by: 


0  = 


p(s-i)g4 


(51) 


0 


w 


p(s-l)gd50 


(52) 


Equation  50  has  to  be  solved  simultaneously  with  the  expression  for  the 
shear  stress,  because  the  roughness  depends  on  the  stress.  Explicit  predictive 
equations  were  developed  using  approximating  polynomials  to  the  exact  solution 
avoid  time-consuming  iteration  in  calculating  the  shear  stress. 

Based  on  the  roughness  estimate,  friction  factors  for  current  fc  and  waves  fw 
are  separately  computed  according  to  Soulsby  (1997)  and  Swart  (1974), 
respectively  as: 


4=2 


K 


l  +  ln(4/30</) 


(53) 
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/M,=exp(5.2UT019-6.0) 
L=  0.3 


—  >1.57 

K 

(54) 

—  <1.57 

K 


where  k  =  Von  Karman  constant  (taken  to  be  0.4).  Shear  stress  from  the  current 
is  given  by: 


T  =Ip  fu2 

c  wJ  c  c 

whereas  the  maximum  shear  stress  from  the  waves  is  estimated  from: 
T  =-p  fU2 

W  wJ  W  W 

and  the  mean  shear  stress  is  obtained  from: 


(55) 

(56) 


Vm=0.5T„  (57) 

where  a  sinusoidal  wave  is  assumed.  The  corresponding  shear  velocities  for 
current  and  waves,  respectively,  are  defined  as: 

(58) 

for  the  current,  and: 


for  the  waves  (based  on  the  maximum  shear  stress). 


(59) 


Bed  load 

A  general  transport  formula  for  bed  load  qb  under  combined  waves  and 
current  was  developed  by  Camenen  and  Larson  (2005): 


(60) 


where  subscripts  w  and  n  refer  to  the  wave  direction  and  the  direction  normal  to 
the  waves,  respectively,  a  and  b  are  coefficients,  and  0C>V  m  and  Qcw  are  the  mean 

and  maximum  Shields  parameter  for  waves  and  current  combined,  respectively, 
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not  including  the  bed  form  roughness.  The  coefficient  an  =  12  for  the  transport 
component  normal  to  the  wave  direction  (current-driven  transport).  The 
coefficient  b  describes  initiation  of  motion  and  is  specified  as  b  =  4.5. 

The  quantities  Qnet  and©cw  represent  the  net  contribution  of  the  shear  stress  to 

the  transporting  velocity  during  a  wave  cycle  in  the  direction  parallel  and  normal 
to  the  waves,  respectively,  defined  as: 

enet  =  ec*,on  +  0cw,<#  (61) 

in  which: 


0  =  1  f 

° CW,On  rji  J 

*wc  o 

1  T 

®cw,off  —  J  J" 
1  wt  T 


1/C.K(0  +  Vcostf 
2  (.S’  - \)gdM 

1  /cw(m»X0  +  Vcos(1))2 

2  (.s-l)grf50 


(62) 


and 


1  ,  {Uc  sin 4>) 

2Jc(s-l)gd 


where  Twc  =  period  of  positive  flow,  ,  =  period  of  negative  flow,  and  uw  =  time- 
varying  horizontal  bottom  orbital  velocity  (  T  =  Twc  +  Twt ).  Analytical  solutions  to 
these  equations  are  available  for  simple  expressions  of  uw.  The  friction  factor  for 
combined  wave  and  current  flow  is  calculated  from  Madsen  and  Grant  (1976): 


fcw  =  xjc+{\-xv)fw  (64) 

where  Xv  =  \UC  |  /  (|[/c  |  +  Uw )  and  fc  and  fw  are  the  friction  coefficients  for  current 

only  and  waves  only,  respectively,  not  including  the  bed  form  roughness.  The 
Shields  parameter  that  determines  the  amount  of  sediment  mobilized  for  transport 
is  obtained  as: 


0  —  i 02  +  02  +20  0  cos(b) 

cw,m  \  c  w,m  w,m  c  t  J 

and  the  Shields  parameter  applied  in  the  initiation  of  motion  term  is: 
+  =  (e+  +  2e A  cos(|))1/2 


(65) 


(66) 


where  0C  and  0w  are  the  Shields  parameters  for  current  only  and  waves  only, 
respectively,  and  the  index  m  denotes  the  mean  value.  For  sinusoidal  waves, 

0  = 0  12. 

w,m  w 


Values  of  the  transport  rate  coefficients  were  obtained  through  calibration 
against  a  large  data  set  from  laboratory  and  field  experiments  involving  a  mean 
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current,  oscillatory  waves  (sinusoidal  and  asymmetric),  and  combined  waves  and 
current.  A  wide  range  of  current  and  wave  velocities,  grain  sizes,  and  roughness 
conditions  were  covered  in  this  combined  data  set.  The  following  relationship 
was  developed  for  the  transport  coefficient  in  the  wave  direction  (Camenen  and 
Larson  2005): 

aw  =  6  +  6Xt 

X,S-  (67) 

e  +e 

c  w 


In  many  applications,  the  waves  are  assumed  to  be  sinusoidal,  having  no 
asymmetry.  Thus,  the  contribution  to  the  transporting  velocity  from  the  waves  is 
negligible,  implying  that  only  the  current  moves  the  material.  Waves  are  still 
important  for  mobilization  of  the  sediment.  For  such  conditions,  Equation  60 
simplifies  to: 


Vbc 


yl(s~l)gd. 


=  a„XcQ™,,„  eXP 


f  n  A 
-b^~ 

V  ®cwj 


(68) 


where  the  transport  q^c  is  obtained  in  the  direction  of  the  current,  and  the 
transport  normal  to  the  current  is  zero.  (There  is  no  velocity  component  to  move 
the  material  in  this  direction.) 


Suspended  load 

The  suspended  load  qs  is  calculated  based  on  the  assumptions  of  an 
exponential  concentration  profile  and  a  constant  velocity  over  the  water  column 
to  yield  (Camenen  and  Larson  2006): 


8  1 

f 

r  wfd  y 

o 

II 

Sr? 

1-exp 

W,1 

V 

V  8  Jy 

where  vty  =  sediment  fall  speed,  cR  =  reference  concentration,  and  8  =  sediment 
diffusivity  (or  mixing  coefficient).  The  transport  qs  is  taken  to  be  in  the  direction 
of  the  current  because  the  waves  are  assumed  to  produce  a  zero  net  drift  and  not 
contribute  to  the  transport.  In  the  calculation  of  cR  and  8 ,  the  total  shear  stress 
should  be  applied,  including  the  bed  form  roughness.  The  reference 
concentration  is  given  by: 


CR  =  eXP 


V 


0 


cw  J 


where  the  coefficient  .1 ,,  is  determined  by  the  following  relationship: 


(70) 


AcR  =  3.5  •  10"3  exp(-0.3(i«) 

and  the  dimensionless  grain  size  is  defined  by  d»  =  ((s  -  l)g  / v2 )  d50 .  The 

sediment  diffusivity  is  related  to  the  energy  dissipation  according  a 
generalization  of  the  treatment  of  Battjes  (1975): 
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d 


(72) 


VP  J 

where  De  is  a  total  effective  dissipation  given  by: 

D  =  k3D  +k3D  +klDh  (73) 

e  c  ec  w  ew  b  eb  V  / 

in  which  kc ,  kw ,  and  kb  are  coefficients.  The  dissipations  from  bottom  friction  due 
to  current  Dec  and  from  bottom  friction  due  to  waves  Dew  are  expressed  as: 

Ac  =  XcUc*  (74) 

Aw  —  XwUw*  (7^) 

and  the  dissipation  due  to  wave  breaking  Deb  is  directly  provided  from  a  wave 
transformation  model  (e.g.,  STWAVE.  WABED).  The  coefficient  kb 
corresponds  to  an  efficiency  factor  and  was  found  to  be  0.017,  whereas  kc  and  kw 
are  related  to  the  Schmidt  number  that  expresses  the  ratio  between  diffusivity  of 
sediment  and  water  (i.e.,  momentum).  These  two  coefficients  are  given  by: 


K  =7a«K  (76) 

6 

where  a.  =  Schmidt  number  and  the  subscript  i  =  c  or  w  denotes  current  and 
waves,  respectively.  The  Schmidt  number  is  calculated  from  the  empirical 
relationships: 


a .  =  Ax+  A2  sin2  5 
a.  =  \  +  (Ax  +A2  —  1)  sir 


wf 

-^<1 

v2w,.y 

l)sin25 

Wf 

y2wfj 

Up 

(77) 


where  Ai  =  0.7  and  A2  =  3 .6  for  current,  and  Aj  =  0.09  and  A2  =  1 .4  for  waves.  In 
the  case  of  coexistent  waves  and  current,  a  weighted  Schmidt  number  is  applied 
according  to: 


<V=V5°c+(l-Xv)° 
for  both  waves  and  current. 


(78) 


Bed  load  and  suspended  load  transport  rates  are  set  to  zero  at  the  beginning 
of  the  simulation,  then  updated  at  each  sediment  transport  time  step. 

Advection-Diffusion  (AD)  Equation 

Calculations  of  suspended  load  and  bed  load  are  conducted  separately 
through  solution  of  the  AD  equation  for  suspended  load.  This  method  calculates 
the  suspended  load  in  the  water  column  through  the  lateral  and  vertical 
movement  of  the  sediment. 
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Basic  equations 

Sediment  transport  consists  of  two  components,  bed  load  and  suspended 
load.  The  bed  load  and  suspended  load  transport  rate  formulas  are  based  on  the 
local  shear  stress.  However,  in  the  situation  where  the  suspended  sediment 
concentration  rapidly  changes  in  time  and  space,  such  as  at  a  river  mouth,  inlet 
entrance,  navigation  channel,  and  in  the  vicinity  of  structures,  the  suspended  load 
cannot  be  determined  solely  by  the  local  forcing  conditions.  In  this  case, 
suspended  sediment  concentration  is  governed  by  the  AD  equation. 

The  AD  equation  implemented  in  CMS-M2D  is  obtained  from  the  continuity 
of  depth-averaged  suspended  sediment  transport  (Figure  2)  as: 


<KCd)  ,  d(Cqx)  t  d(Cqy) 

dt  dy 


-^1  Kd^P 


dx 


dx 


d 

+  dy 


+  P-D 


(79) 


in  which 


C  =  depth-averaged  sediment  concentration 
d  =  total  depth  (=  /z+rj) 
h  =  still-water  depth 

T)  =  deviation  of  the  water-surface  elevation  from  the  still-water  level 
t  =  time 

qx  =  flow  per  unit  width  parallel  to  the  x-axis  (=  ud) 

qy  =  flow  per  unit  width  parallel  to  the  y-axis  (=  vd) 

u  =  depth-averaged  current  velocity  parallel  to  the  x-axis 

v  =  depth-averaged  current  velocity  parallel  to  the  y-axis 

Kx  =  sediment  diffusion  coefficient  for  the  x  direction 

Ky  =  sediment  diffusion  coefficient  for  the  y  direction 

P  =  sediment  pick-up  rate  (upward  sediment  flux) 

D  =  sediment  deposition  rate  (downward  sediment  flux) 

The  suspended  sediment  concentration  can  be  solved  from  Equation  79  at  a 
sediment  transport  time  step. 
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Figure  2.  Definition  of  continuity  (conservation  of  volume)  of  sediment  transport 


Bed  level  change  is  obtained  from  the  sediment  continuity  equation: 


dh 

37 


1 


1  ~P 


dqbx  ,  <kL 


+  - 


by 


dx  dy 


+  P-D 


(80) 


where  qbx  =  bed  load  transport  rate  parallel  to  the  x-axis,  qby  =  bed  load  transport 
rate  parallel  to  the  y-axis,  and  p  =  porosity  of  sediment. 

In  Equation  80,  the  terms  dqbx/dx  +  dqby/dy  include  the  bed  load  component, 

and  the  term  P-D  corresponds  to  the  suspended  load  component.  Figure  2 
shows  the  definition  of  sediment  continuity  in  a  water  column,  where  qsx  and  qsy 
are  the  suspended  transport  rate  in  the  x  andy  directions,  respectively,  and  a  is 
the  height  of  the  bed  load  layer.  The  transport  rates  qsx  and  qsy  may  be  defined  as 


follows  from  Equation  79: 

q  —  Cq  —  K  d 

Ysx  Yx  x  A 

dx 

(81) 

%=Cqy~Kyd ^ 

(82) 
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Sediment  concentration  and  bed  load  and  suspended  load  transport  rates  are 
set  to  zero  at  the  beginning  of  the  simulation,  then  updated  at  each  sediment 
transport  time  step. 

Pick-up  and  deposition  rates 

The  AD  model  calculates  the  bed  level  change  due  to  suspended  load  from 
the  difference  between  pick-up  rate  and  deposition  rate  in  Equation  80.  The 
pick-up  rate  and  the  deposition  rate  are  also  applied  as  the  bottom  boundary 
condition  in  Equation  79.  The  boundary  conditions  are  specified  at  an  arbitrary 
level  a  above  the  mean  bed  level: 

=  CaWf  (83) 

D  =  c0wf  (84) 

where  c  =  equilibrium  concentration  of  suspended  sediment  at  a  given  elevation, 
and  z  =  vertical  coordinate.  Both  ca  and  c0  are  reference  concentrations  defined 
at  z  =  a.  Because  the  upward  flux  of  sediment  depends  on  the  bed  shear  stress,  ca 
is  determined  from  the  bed  shear  stress  calculated  from  the  local  hydrodynamic 
conditions.  Representation  of  ca  within  CMS-M2D  is  dependent  on  selection  of 
either  the  van  Rijn  or  Lund-CIRP  models.  The  downward  sediment  flux  depends 
on  the  concentration  in  the  upper  water  column;  therefore,  c0  is  specified  from 
solution  of  Equation  79. 

Assuming  that  the  suspended  concentration  is  in  equilibrium  (dc/dt  =  0  , 
du/dx  =  dv/dy  =  0 ,  dc/dx  =  dc/dy  =  0 ),  then  the  basic  equation  for  suspended 
sediment  concentration  can  be  written: 

cWr  +  £— —  =  0  (85) 

dz 

This  equation  can  be  solved  analytically  by  applying  an  appropriate  mixing 
coefficient  8,  and  the  vertical  profile  of  suspended  concentration  is  obtained  in 
the  following  form: 

c(z)  =  c0F(z )  (86) 

where  F(z)  is  a  function  of  the  vertical  concentration  distribution.  The 
relationship  between  the  reference  concentration  c0  and  the  depth-averaged 
concentration  C  is: 

C  =  — —  J  c0F(z)dz  (87) 

a  -  a 

Thus,  Co  may  be  written  in  the  following  form  by  introducing  a  conversion 
function  (3^: 
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c 


(88) 


C 

~°  1  td  R 

— - —  f  F(z)dz  pJ 
d  -  aia 

The  bed  level  change  due  to  suspended  load  is  based  upon  the  difference  of 
the  two  types  of  reference  concentration: 

P-D  =  (ca-c0)wf  (89) 

This  equation  implies  that  erosion  occurs  if  ca  >  c0,  and  accretion  occurs  if 

ca  <  c0. 

In  the  AD  model,  three  methods  of  specifying  ca  and  c0  (that  is,  P</)  are 
implemented.  Two  of  the  methods  are  based  on  the  van  Rijn  formula  (van  Rijn 
1985)  and  one  on  the  Lund-CIRP  formula  (Camenen  and  Larson  2006).  Table  1 
summarizes  general  features  of  the  methods. 

van  Rijn  formula 


The  reference  concentration  ca  in  the  van  Rijn  formula  is  given  by: 


c  =0.015^2- 


.s',  max  cr 


—  T 


V 


7-0.3 


(90) 


where  a  =  reference  height  and  r^max  =  maximum  bed  shear  stress  given  by 
Equation  38. 


Table  1 

Features  of  Calculation  of  Pick-up  and  Deposition  Rates 

Method 

Reference  Conversion 

Concentration  Parameter 

Comments 

Exponential 

Profile 

Eq.  90 

Eq.  104  and  105 

Fast  computation. 

Tends  to  overestimate 
sediment  transport  rate. 

Can  be  used  for  some 
tests. 

Van  Rijn 

Profile 

Eq.  90 

Solves  Eq.  85 
numerically  with 
Eq.  103  (Runge- 
Kutta  4th) 

Requires  substantial 
computing  time. 

Provides  the  same  results 
as  van  Rijn  (1985). 

Lund-CIRP 

Profile 

Eq.  70 

Eq.  104  and  72 

Fast  computation. 

Newly  developed 
sediment  transport 
formula. 

Chapter  3  Governing  Equations  for  Sediment  Motion  and  Methods  for  Morphologic  Constraints 


27 


The  current-related  shear  stress  is  calculated  from: 


x  = _ _ -£/2 

[l  +  ln(/t;/30d)] 

The  wave-related  shear  stress  is  given  as: 

/w=exp[5.5(^/A:;)-a2-6.3j 

where  ks  =  roughness  height  defined  as: 


(91) 


(92) 

(93) 


K  =ksd  +kS, 


in  which  ksd  and  kss  are  calculated  from  Equations  37  and  50,  respectively. 


(94) 


Bed  concentration  in  the  van  Rijn  model  is  defined  at  the  height  a  as: 
a  =  max(0.5 Hr  ,0.01  d) 

where  Hr  =  ripple  height.  If  ripples  are  present,  the  total  roughness  height  is 
modified  as: 


k 


s 


=  K+Kf 


(96) 


where,  ksf  =  20(H2/Lr)  is  specified  for  the  van  Rijn  formula,  and  ksf  =  1 .5  (H 2 /L}) 
is  specified  for  the  Lund-CIRP  formula.  The  ripple  dimension  is  obtained  by 
selecting  the  largest  ripple  height  for  the  case  of  current  or  waves  (Equations  46 
and  47). 


The  conversion  parameter  $d  to  determine  c0  is  obtained  from  the  vertical 
mixing  coefficient.  Van  Rijn  (1985)  proposed  a  distribution  of  the  mixing 
coefficients  for  only  current  or  waves  according  to  Figure  3.  The  current-related 
mixing  coefficient  is  given  by: 


f 


8=8  - 

c  c,  max 


2 


i- 

v  h 


z  <  0.5 h 


ec=£c,  max  =0.25K.utch 


z  >  0.5/z 


(97) 


where  u*c  =  current-related  bed  shear  velocity  expressed  as: 


K 


— 1  +  ln 


'30 


^U. 


v  K  j 


(98) 
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and  ft  is  a  coefficient  obtained  from: 


ft  =  -0.25^7 +  2 


0<^y<4 

P\ 


ft  =  l 


(99) 


The  wave-related  mixing  coefficient  is: 


^  ^w,bed 


z  <  8 


^w,bed  (^vv,max  ^vv,bed  ) 


z-8  ^ 
0.5  /z-8 


8  <  z  <  0.5/z 


(100) 


8 


w 


=  8 


vi’,  max 


where 


z  >  0.5/z 


A,  bed  =  0.00065A«„5uh, 


^w.max  =0.035afer 


hH 


afer=5 


v  «  y 


-2 


a6r=l 


H/h  >0.6 
H/h  <0.6 


(101) 


(102) 


in  which  the  parameter  8  =  height  from  the  bed  given  by  8  =  3 Hr ,  H  = 
significant  wave  height,  and  T  =  significant  wave  period.  If  waves  and  current 
coexist,  the  combined  mixing  coefficient  is  given  by: 
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(103) 
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By  applying  the  expression  for  zcw,  the  concentration  profile  can  be  derived 
from  Equation  85,  and  the  conversion  parameter  calculated.  In  the  AD-model 
based  on  the  van  Rijn  equations,  two  methods  are  implemented  to  calculate  (3,/. 
One  is  based  on  an  exponential  profile  employing  a  depth-averaged  mixing 
coefficient  zcw ,  and  the  other  uses  the  original  van  Rijn  profile,  where  the  $d  is 
obtained  by  numerical  integration  of  Equation  85.  Assuming  an  exponential 
profile  of  suspended  sediment  concentration,  $d  is  obtained  analytically  as: 


p,= 


i 


d  -a  wf 


(  ...  \\ 

1-exp 

\  ecw  J 

(104) 


where 


Lund-CIRP  formula 


(105) 


Reference  concentration  and  sediment  diffusivity  calculated  by  the  Lund- 
CIRP  formula  may  also  be  applied  in  the  AD-model.  The  formulas  used  for  cR 
and  8  are  presented  in  the  section  describing  the  Lund-CIRP  formula. 


Horizontal  diffusion  coefficient 


Horizontal  diffusion  coefficients  Kx  and  Ky  for  the  depth-averaged  sediment 
concentration  in  the  AD  equation  are  calculated  by  the  equation  proposed  by 
Elder  (1959): 


Kxo  =5.93  u*cd 
Kyo  =5.93  u*cd 


(106) 


In  the  surf  zone,  waves  contribute  significantly  to  lateral  mixing,  and  the 
eddy  viscosity  coefficient  is  expected  to  be  a  function  of  the  wave  properties. 
For  the  horizontal  diffusion  coefficients  for  AD  equation,  surf  zone  mixing 
proposed  by  Kraus  and  Larson  (1991)  is  applied  as  well  as  for  hydrodynamic 
calculation. 


K 


(107) 


where  8L  describes  the  lateral  mixing  below  trough  level  (Smith,  Larson,  and 
Kraus,  1993)  and  is  expressed  as  (Kraus  and  Larson  1991): 


ei  =  AuwH 


(108) 


where  A  =  empirical  coefficient  representing  the  lateral  mixing  strength. 
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The  transition  between  surf  zone  diffusion  and  oceanic  diffusion  seaward  of 
the  breakpoint  is  represented  in  CMS-M2D  by  a  weighted  mixing  coefficient 
specified  as: 


*,=(1  -ej^+e.Ar. 

*,=  (i~0. 


(109) 


where  the  weighting  parameter  0m  is  given  by: 


0  = 


f  H  V 


/?  +  77 


(110) 


Bed  load  transport  rate 


Bed  load  transport  rate  may  be  calculated  with  the  van  Rijn  (1998)  or  Lund- 
CIRP  (Camenen  and  Larson  2005)  formula.  In  the  van  Rijn  formula,  bed  load 
transport  rate  is  obtained  from,  not  including  bed  roughness: 


qb  =0.k/5( 


V-5 


d~ 


(111) 


The  Lund-CIRP  formula  for  bed  load  is  described  previously  in  this  chapter. 


Scaling  Factors  for  Bed  Load  and  Suspended 
Load  Transport  Rates 

Adjustments  to  the  bed  load  and  suspended  load  transport  rates  can  be 
assigned  for  both  the  Lund-CIRP  total  load  formulation  and  the  AD  equation. 
Scaling  factors  are  applied  directly  to  transport  rate  values  as  coefficients 
independently  for  the  bed  load  transport  rate  and  for  the  suspended  load  transport 
rate.  Thus,  the  bed  load  transport  rate  can  be  scaled  separately  from  the 
suspended  load  transport  rate.  Recommended  ranges  for  the  scaling  factors  are 
0.1  to  4.  A  scaling  factor  of  1  will  not  modify  the  transport  rate,  and  this  value  is 
the  default.  Values  less  than  1  will  reduce  the  transport  rate,  and  values  greater 
than  1  will  increase  it.  Scaling  factors  are  sometimes  found  necessary  because  of 
uncertainties  in  forcing  and  initial  conditions,  allowing  adjustment  of  model 
predictions  of  sediment  transport  rates  and  morphology  change  to  observations. 

Sediment  Continuity  Equation 

Depth  change  for  the  total  load  formulations  and  for  bed  load  transport  from 
the  AD  equation  is  calculated  by  the  sediment  continuity  equation,  in  which 
time-averaged  transport  rates  are  applied.  This  approach  requires  that  two  time 
intervals  be  defined,  one  over  which  to  compute  instantaneous  transport  rates 
dtsed  and  the  other  over  which  to  compute  averaged  transport  rates  and 
morphology  change  dtmorph.  Directional  instantaneous  transport  rates  qtot  x  and 
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qtot  y  are  calculated  at  intervals  of  dtsed  and  averaged  over  the  time  interval  dtmorph 

to  obtain  the  time-averaged  transport  rates  qtot  x  and  qtot  y  for  the  x  and  y 

directions,  respectively.  Enhancement  of  down-slope  transport  and  reduction  of 
up-slope  transport  rates  is  accomplished  by  calculation  of  modified  time- 

averaged  transport  rates  qtotx  and  qtoty  as  (Watanabe  1987): 

dh 

Vtot'X  ~  Vtot'X  ~  |  Qtot  I  0^  (112) 

dh 

qtol,y=qto,,y-Ds\q,ot\-~r  (113) 

in  which  Ds  =  empirical  slope  coefficient  with  typical  range  of  5  to  30,  and 
qtot  is  the  time-averaged  transport  rate.  These  formulations  add  an  effective 
diffusion  of  transport  to  the  continuity  equation  for  bed  change. 


The  sediment  continuity  equation  is  solved  to  compute  depth  change  at  the 
time  interval  dtmorph  and  for  total  load  formulations  is  given  by: 


dh 

dt 


1  ~P 


tot,x 


dx 


+  - 


dqt 


tot,y 


dy 


(114) 


At  forcing  boundaries,  the  gradient  in  transport  rate  across  the  boundary  cell 
is  set  to  zero. 


For  the  AD-model,  the  sediment  continuity  equation  is  provided  by 
Equation  80.  The  time  intervals  to  compute  instantaneous  transport  rates  and  to 
compute  averaged  transport  rates  and  morphology  change  are  consistent  with 
those  applied  in  the  total  load  model,  that  is,  dtsed  and  dtmorph  respectively.  Also, 
the  bed  load  components  in  Equation  80  are  modified  by  the  slope  effect  as: 


^  _  n  |-  |  dh 

<lbx=<lbx 

(115) 

-  n  i_  |  dh 

%  =<lby  -Ds\qb\  — 

(116) 

where  qb  =  ^qbx  +  qby  .  Finally,  the  sediment  continuity  equation  is  solved  to 
compute  depth  change  at  the  time  interval  dtmorph  and  is  rewritten  as: 


dh 

dt 


1  ~p 


+  - 


by 


dx  dy 


+  P  —  D 


(117) 


which  contains  both  bed  load  and  suspended  load  components.  At  forcing 
boundaries,  the  gradient  in  transport  rate  across  the  boundary  cell  is  set  to  zero. 


Hard-Bottom  Methodology 
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Representation  of  hard  (non-erodible)  substrate  provides  the  capability  to 
simulate  mixed  bottom  types  within  a  single  simulation.  The  default  bottom  type 
in  CMS-M2D  is  erodible,  meaning  that  sediment  is  available  to  be  transported 
from  that  area.  Areas  having  hard  bottom  are  specifically  designated  as  such  in 
the  model,  and  the  depth  of  the  hard  substrate  is  specified,  allowing 
representation  of  either  exposed  or  sediment-covered  hard  bottom.  The  one¬ 
dimensional  (ID)  hard-bottom  calculation  approach  applied  in  the  GENESIS 
shoreline  change  model  (Hanson  1989;  Hanson  and  Kraus  1989)  to  represent  the 
control  of  seawalls  on  shoreline  evolution  (Hanson  and  Kraus  1985,  1986)  was 
extended  to  two  dimensions  and  implemented  in  CMS-M2D  (Hanson  and 
Militello  2005). 

The  presence  of  hard  bottom  exerts  a  constraint  on  water  depth  because  the 
bottom  cannot  erode.  Representation  of  hard  bottom  applies  an  adjustment  to  the 
potential  transport  rates  (calculated  by  a  transport  formulation  with  no  restriction) 
to  account  for  the  presence  of  hard  substrate.  Treatment  of  hard  bottom  was 
developed  to  satisfy  the  following  four  properties: 

a.  Areas  having  hard  bottom  cannot  erode  below  the  level  of  the  hard 
substrate. 

b.  Sediment  volume  is  conserved. 

c.  The  direction  of  sediment  transport  at  a  location  with  hard  bottom  is  the 
same  as  that  of  the  direction  of  potential  local  transport. 

d.  Correction  to  transport  rates  is  always  done  in  the  direction  of  potential 
sediment  transport.  If  hard  bottom  is  exposed,  the  reduction  in  actual 
transport  as  compared  to  the  situation  without  hard  bottom  is  always 
transmitted  to  neighboring  areas  in  the  direction  of  transport  as  governed 
by  the  hydrodynamic  forcing. 

The  general  procedure  for  treating  hard  bottom  is: 

a.  Calculate  sediment  transport  and  morphology  change  without  hard- 
bottom  restriction. 

b.  Assess  whether  hard-bottom  cells  have  eroded  below  the  hard  bottom 
depth.  If  so,  apply  a  correction  procedure  that  adjusts  transport  rates 
based  on  available  sediment  at  hard-bottom  cells  and  corrects  depths  so 
that  the  hard-bottom  constraint  is  not  violated.  The  correction  procedure 
makes  adjustments  at  all  cells  in  which  transport  rates  are  controlled  by 
hard  bottom  and  can  include  adjustments  at  cells  that  do  not  have  hard 
bottom. 

The  correction  procedure  involves  four  steps: 

a.  Identify  all  cells  that  have  transport  at  all  four  faces  directed  out  of  the 
cell,  called  “Minus4”  cells.  These  Minus4  cells,  if  they  exist,  must 
constitute  the  first  stage  of  corrections,  as  they  are  only  'deliverers'  of 
sediment  to  all  adjacent  cells,  not  'recipients'  of  material. 

b.  If  the  hard  bottom  is  exposed,  all  transport  rates  out  of  the  Minus4  cells 
are  reduced.  A  list  of  all  adjacent  cells,  with  or  without  hard  bottom,  that 


Chapter  3  Governing  Equations  for  Sediment  Motion  and  Methods  for  Morphologic  Constraints 


33 


are  influenced  by  exposed  hard-bottom  cells  is  generated  for  later 
correction  to  depths  and  transport  rates. 

c.  Depths  at  all  adjacent  cells  are  then  recalculated  to  account  for  the 
reduced  influx  of  sediment.  Cells  with  hard  bottom  must  then  be 
checked  for  a  possible  violation  of  the  hard-bottom  constraint  and 
corrected  as  necessary.  For  each  corrected  cell,  all  sediment  transport 
rates  out  of  the  cell  are  in  turn  corrected,  and  each  of  the  next  generation 
of  affected  cells  adjacent  to  it  is  added  to  the  list  of  cells  to  be  corrected. 
Transport  rates  into  a  cell  are  never  changed  (as  it  is  an  outgoing 
transport  from  the  adjacent  cell  that  is  corrected  in  that  cell). 

d.  After  all  cells  have  been  checked,  the  process  is  repeated  to  make  sure 
that  the  hard-bottom  constraint  is  not  violated  in  any  cell. 

Corrections  to  transport  rates  and  depths  are  based  upon  the  potential 
transport  rate  and  amount  of  sand  available  for  erosion.  If,  after  solution  of  the 
sediment  continuity  equation  (Equation  1 14),  the  updated  depth  ti  is  greater 
than  the  hard-bottom  level  hhb ,  the  outgoing  transport  rates  are  corrected  to 

match  the  criterion  ti  —  hhb .  Over  one  morphologic  time  step,  the  total  amount 
of  material  havail ,  expressed  as  a  vertical  quantity  that  may  leave  the  cell  without 
violating  the  hard-bottom  constraint  is: 

K,aU=(hhb-h')  +  ^f-  (H8) 

ax  ay 

where  qin  =  total  influx  of  sediment  from  the  cell  during  the  morphologic  time 
step.  The  correction  factor  K  is  given  as: 


K  = 


<loutdt 


(119) 


where  qout  =  total  outflux  of  sediment  from  the  cell  during  the  morphologic  time 
step.  To  ensure  that  ti  —  hhb  ingoing  transport  rates  are  left  unchanged,  and 
outgoing  transport  rates  are  multiplied  by  the  correction  factor  K. 


A  schematic  example  of  the  correction  procedure  is  provided  for  a  symmetric 
computational  grid  (Figure  4).  The  domain  contains  a  9-by-9  grid  of  calculation 
cells.  Rows  (parallel  to  the  x-axis)  are  numbered  1  through  9,  and  columns 
(parallel  to  the  y-axis)  are  indicated  by  A  through  I.  Initial  bathymetry  level  is 
specified  to  be  z  —  0  at  all  cells,  and  the  hard-bottom  level  is  at  z  —  5  (units)  at 
all  cells  (z  is  positive  downwards  from  the  original  bottom  level  at  z  =  0 ). 

Arrows  across  the  cell  walls  indicate  the  initial  (potential)  transport  rates. 
These  are  of  three  different  magnitudes:  2  units/m/s  (black  arrows),  5  units/m/s 
(blue  arrows),  and  12  units/m/s  (green  arrows).  For  demonstration  purposes  we 
assume  that  the  cell  sizes  in  the  x-direction  and  the  y-direction  are  the  same  and 
that  a  transport  rate  of  1  unit/m/s  during  one  time  step  corresponds  to  a  bottom 
elevation  change  of  1 . 
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Numbers  inside  each  cell  indicate  the  potential  depth  change  (positive 
numbers  mean  erosion)  in  each  cell,  which  is  a  measure  of  the  magnitude  of  the 
depth  change  if  the  hard  bottom  were  not  there.  Thus,  in  each  cell  with  a  depth 
change  that  is  greater  than  5,  the  hard  bottom  is  exposed.  As  a  result,  the  actual 
depth  change  is  limited  to  5.  Once  this  depth  is  reached,  the  transport  out  of  the 
cell  is  reduced  owing  to  limited  sediment  availability. 

In  the  model,  this  reduction  is  accomplished  through  a  correction  procedure. 
The  following  section  explains  how  this  correction  is  performed  through  three 
successive  correction  loops  in  a  hierarchical  and  systematic  order. 


Figure  4.  Schematic  hard-bottom  grid  and  potential  transport  rates 


Correction  loop  1: 

a.  Find  cells  with  transport  rates  directed  out  of  the  cell  through  all  four 
faces.  These  cells  represent  the  ultimate  starting  points.  Cell  E5  is  the 
only  cell  in  this  example  having  outward-directed  transport  rates  through 
all  four  faces. 

b.  Calculate  the  new  bottom  level  equaling  8  units,  which  means  that  the 
hard  bottom  at  5  units  is  exposed. 

c.  Reduce  all  transport  rates  out  of  cell  E5  in  proportion  to  the  sediment 
deficit.  The  potential  loss  of  sediment  was  8  units  while  the  available 
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volume  in  cell  E5  was  5  units.  Thus,  the  outgoing  transport  rates  will  be 
reduced  from  2  to  2  x  5/8  =  1.25  units/m/s. 

d.  Recalculate  depths  of  all  adjacent  cells,  D5,  E4,  F5,  and  E6,  based  on 
modified  transport  rates. 

e.  Hard  bottom  is  now  exposed  in  cells  E4  and  E6. 

f  Reduce  transport  rates  out  of  these  two  cells  (E4  and  E6). 

g.  Recalculate  depths  of  cells  adjacent  to  E4  and  E6  that  receive  sediment. 
These  cells  are  D4,  E3,  F4  and  D6,  F6,  E7.  No  additional  hard-bottom 
cells  are  exposed.  Thus,  the  deficit  associated  with  cell  E5  does  not 
spread  further. 

Correction  loop  2: 

h.  Find  start  cells  from  where  sand-deficit  might  spread  by  searching 
through  the  grid  from  one  end  to  the  other.  Start  cells  are  those  that  are 
located  on  a  hard  bottom,  but  do  not  receive  sediment  from  any  other 
hard-bottom  cell. 

i.  Find  exposed  cells  (defined  as  cells  where  the  hard  bottom  is  exposed) 
and  identify  by  flag  IEXP  =  1 .  Start  the  search  in  cell  A1 .  This  cell  is 
exposed,  but  sediment  is  coming  in  from  B1  that  is  also  exposed.  The 
direction  of  influence  will  be  in  the  direction  of  transport,  i.e.,  from  B1  to 
Al.  Thus,  A1  cannot  be  a  start  cell. 

j.  Next,  proceed  to  cell  A2.  This  cell  is  exposed  but,  as  above,  it  is 
receiving  sediment  from  cell  Al,  which  is  also  exposed.  Thus,  cell  A2  is 
not  a  start  cell. 

k.  The  same  situation  prevails  for  all  cells  in  the  A  column.  Thus,  no  cells 
in  the  A  column  are  start  cells. 

/.  Next,  proceed  to  cell  Bl.  This  cell  is  exposed.  It  is  only  getting  sand 
from  B2,  but  that  cell  is  not  exposed,  so  no  correction  can  come  from 
there.  Thus,  cell  Bl  is  a  start  cell. 

m.  All  remaining  cells  are  checked  the  same  way,  and  all  start  cells  are 
added  as  necessary  to  the  list  of  cells  to  be  corrected  (here  referred  to  as 
the  correction  list). 

n.  Correct  the  first  cell  in  the  correction  list,  cell  Bl.  Add  adjacent  cells 
receiving  sediment  from  Bl  to  the  correction  list,  i.e.,  cells  Al  and  Cl. 

o.  Proceed  through  all  start  cells,  correct  outgoing  transport  rates,  and  add 
to  the  correction  list  all  cells  receiving  sediment  from  the  start  cells. 

Correction  loop  3: 

p.  The  next  step  is  to  examine  all  cells  connected  to  start  cells.  Transport 
rates  need  to  be  corrected  if  hard  bottom  is  exposed.  Adjacent  cells 
receiving  sediment  are  added  to  the  correction  list  at  the  next  level  of 
correction  cells. 
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Through  this  procedure,  cells  will  always  be  corrected  in  a  hierarchic  order  in 
which  all  cells  of  one  level  are  corrected  before  proceeding  to  the  next  level. 
Corrections  are  always  propagated  in  the  direction  of  transport  without  ambiguity 
regarding  which  cell  affects  another.  Figure  5  shows  the  final  bathymetry  where 
all  (positive)  depth  changes  are  less  than  5.  The  figure  also  shows  the  transport 
rates  that  were  unchanged  within  this  correction  procedure  (indicated  by  their 
original  colors)  together  with  those  transport  rates  that  were  changed  (indicated 
by  red  arrows).  It  should  be  noted,  however,  that  the  red  arrows  represent 
transport  rates  with  very  different  magnitudes. 

Through  the  correction  loops,  transport  rates  modified  by  the  hard-bottom 
algorithm  are  not  restricted  to  cells  specified  as  having  non-erodible  substrate. 
Adjustments  to  transport  rates  take  place  at  hard-bottom  and  erodable  cells  and 
the  spatial  extent  of  the  modifications  is  dependent  on  the  spatial  influence  of  the 
hard  bottom  under  the  transport  conditions. 
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Figure  5.  Corrected  hard-bottom  depths  and  adjusted  transport  rates 


Avalanching  Methodology 

Controls  on  bottom  slope  are  implemented  through  an  avalanching 
algorithm.  After  each  calculation  of  morphologic  change,  every  cell  in  the  CMS- 
M2D  grid  is  evaluated  to  determine  if  a  critical  bottom  slope  has  been  exceeded. 
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If  so,  avalanching  takes  place  to  reduce  the  slope.  By  this  method,  realistic 
bathymetric  slopes  are  maintained  over  the  CMS-M2D  domain.  The  method 
extends  an  algorithm  developed  for  the  Storm-Induced  Beach  (SBEACH)  change 
model  (Larson  and  Kraus  1989)  to  two  dimensions. 

The  procedure  for  determining  if  avalanching  is  needed  is  entered  after  each 
calculation  of  morphologic  change.  Four  slopes  are  computed  for  each  cell  in  the 
grid  using  the  updated  depth  values.  The  slopes  are  computed  between  each  cell 
and  its  four  neighbors  (top,  right,  bottom,  and  left  neighbors).  Starting  at  the 
deepest  cell  in  the  grid,  the  bottom  slopes  are  compared  to  the  critical  slope, 
which  is  the  maximum  slope  allowed  before  avalanching  takes  place.  If  more 
than  one  cell  has  the  same  depth,  cells  are  checked  in  order  of  cell  identification 
number.  If  the  critical  slope  is  exceeded,  avalanching  takes  place  with  the  ending 
slope  being  equal  to  the  residual  slope  after  shearing.  In  the  avalanching  process, 
each  avalanching  calculation  includes  only  the  two  neighboring  cells  that  exceed 
the  critical  slope.  Depths  of  avalanched  cells  are  updated,  and  the  slopes  for  each 
of  the  four  neighboring  cells  recomputed.  If  more  than  one  slope  has  exceeded 
the  critical  slope,  the  steepest  is  avalanched  first  as  it  is  assumed  that  it  would  be 
the  first  to  reach  a  critical  state.  If  there  is  more  than  one  slope  that  exceeds  the 
critical  limit  by  the  same  amount,  then  the  slopes  are  avalanched  from  north  to 
west  in  a  clockwise  fashion. 

After  an  avalanche  has  occurred,  the  slopes  are  recomputed  and  checked  to 
ensure  they  have  not  remained  in  a  critical  state.  If  a  critical  slope  remains,  the 
profile  is  again  avalanched  and  the  process  repeated.  After  all  critical  slopes 
have  been  eliminated,  the  slopes  of  all  affected  cells  are  recomputed  and  the 
algorithm  proceeds  to  the  next  deepest  cell  in  the  grid  to  repeat  the  process.  All 
active  cells  are  checked,  whether  they  are  wet  or  dry.  After  all  cells  have  been 
checked  and,  if  necessary,  avalanched,  slopes  are  again  checked  against  the 
critical  slope.  If  critical  slopes  remain,  the  algorithm  finds  the  deepest  cell  and 
the  entire  process  is  repeated.  If  no  profiles  exceed  the  critical  state,  the 
avalanching  process  is  complete. 

A  bias  can  result  for  cases  where  there  are  multiple  cells  with  the  same  depth 
or  multiple  profiles  that  exceed  the  critical  state  by  the  same  degree.  In  practice, 
however,  it  is  unlikely  that  there  will  repeatedly  be  multiple  cells  with  equivalent 
depths  or  slopes  as  the  values  are  computed  with  a  high  degree  of  precision. 
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4  Numerical  Implementation 
of  Governing  Equations  for 
Water  Motion 


Grid  definition  and  discretization  of  the  governing  equations  are  described  in 
this  chapter.  The  governing  equations  of  CMS-M2D  are  solved  numerically  on  a 
staggered  rectilinear  grid  by  a  finite-volume  calculation  approach.  All  spatial 
derivatives  are  approximated  with  central  differences  with  the  exception  of  the 
advection  terms,  for  which  an  upwind  algorithm  is  applied.  The  momentum 
equations  are  solved  first,  followed  by  the  continuity  equation  wherein  updated 
velocity  values  are  applied. 

To  maximize  efficiency  of  memory  for  domains  with  complex  shoreline 
perimeters,  the  CMS-M2D  grid  is  stored  in  a  ID  array  rather  than  a  2D  matrix. 
The  cell  numbering  convention  is  described  in  this  chapter.  Information  is  also 
given  on  the  Courant  stability  criterion,  which  provides  the  user  with 
understanding  and  an  initial  approximation  of  an  appropriate  model  time  step  for 
the  explicit  solution  method. 

Rectilinear  Grid 

The  governing  equations  are  solved  on  a  discretized  domain  where  cells  are 
defined  on  a  rectilinear  grid  (which  can  be  regular  or  irregular),  as  shown  in 
Figure  6.  Each  cell  has  indices  i  and  j  that  correspond  to  its  position  along  the  x- 
and  y-axes  of  the  grid  domain,  respectively.  Water-surface  elevation  is 
calculated  at  the  cell  center,  whereas  the  x-  and  y-components  of  the  velocity  are 
calculated  on  the  left  face  center  and  bottom  face  center  of  the  cell,  respectively. 
Values  of  flow  rate  per  unit  width,  qx  and  qy,  are  calculated  at  the  same  locations 
as  u  and  v,  respectively.  Note  that  the  notation  for  flow  rate  per  unit  width  is 
similar  to  that  for  sediment  transport  rate.  For  the  present  discussion  on 
hydrodynamics,  lower  case  q  denotes  flow  rate  per  unit  width. 

Because  the  best  orientation  of  the  grid  may  be  such  that  the  x-  and  y-axes  do 
not  correspond  to  geographical  coordinates  (N-S  and  E-W),  cells  in  the  grid  are 
defined  in  a  local  (or  grid)  coordinate  system.  The  local  coordinate  system  is 
referenced  to  geographic  coordinates  by  specification  of  the  angle  between  the  y- 
axis  and  true  north.  A  positive  value  of  this  angle  denotes  clockwise  rotation  and 
the  maximum  rotation  angle  should  not  exceed  45  deg  to  retain  an  orientation  as 
close  to  geographic  as  possible. 
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Figure  6.  Cell  and  variable  definitions  for  CMS-M2D 

The  2D  array  format  for  referencing  cell  locations  is  retained  here  to 
facilitate  presentation  of  the  finite- volume  approximations.  Mapping  of  the  cell 
indices  from  a  2D  array  to  a  ID  array  is  conducted  primarily  to  reduce  computer 
memory  requirements.  The  ID  cell  indexing  method  is  discussed  below. 

Momentum  Equations 

The  finite-volume  scheme  for  the  x-momentum  equation  will  be  given  first, 
followed  by  that  for  the  y-momentum  equation.  Calculation  of  the  bottom  stress 
coefficient,  wind  stress,  eddy  viscosity  coefficient,  and  adjustment  to  the  wave 
stress  for  shallow  water  follow  the  finite-volume  approximation  of  the  y- 
momentum  equation  because  their  descriptions  are  common  for  both  x-  and  y- 
momentum  equations. 

Solution  of  the  momentum  equations  is  conducted  to  calculate  the  x-  and  y- 
components  of  velocity  u  and  v,  respectively.  The  explicit  approach 
implemented  in  CMS-M2D  solves  each  momentum  equation  for  the 

corresponding  flow  rate  per  unit  width  qk+l  or  qk+l  at  the  present  time  step  k+ 1 
from  values  calculated  at  time  step  k.  Velocity  components  uk+l  and  vk+^  are 
then  calculated  from  the  values  of  qk+l  and  qk+l ,  respectively. 


x-momentum  equation 

The  x-momentum  equation  is  solved  explicitly  by  a  finite-volume 
approximation  for  the  control  volume  shown  in  Figure  7.  The  control  volume  is 
indicated  by  the  dashed  line.  Surface  and  bottom  stresses  (wind  stress  and 
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bottom  friction)  are  approximated  on  the  upper  and  lower  surfaces,  and 
momentum  fluxes  are  approximated  at  each  cell  face. 
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Figure  7.  Control  volume  definition  for  x-momentum  equation 


The  x-momentum  equation  in  finite  volume  form  is  given  by: 
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i,  j  =  cell  location  on  the  grid 
k  =  time  step 

AxtJ  =  cell-side  length  parallel  to  the  x-axis 
Ay. .  =  cell-side  length  parallel  to  the  y-axis 
and 
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The  x-directed  current  velocity  is  given  by: 

uk  -2 _ < _ 

and  the  current  speed  for  the  x-momentum  equation  is: 

{vij+vt  u+vij+i+vi-ij+i) 


(124) 
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Wave  stress  for  the  x-momentum  equation  ZSx  is  given  by: 
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y-momentum  equation 

The  y-momentum  equation  is  solved  explicitly  with  a  finite  volume 
approximation  for  a  control  volume  as  shown  in  Figure  8.  The  control  volume  is 
indicated  by  the  dashed  line.  Surface  and  bottom  stresses  are  approximated  on 
the  upper  and  lower  surfaces  and  momentum  fluxes  are  approximated  at  each  cell 
face. 
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Figure  8.  Control  volume  definition  for  y-momentum  equation 


The  y-momentum  equation  is  finite  volume  form  is  given  by: 
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The  y-directed  current  velocity  is  given  by: 
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and  the  current  speed  for  the  y-momentum  equation  is: 


Kj  =  J(u* )  +  (vtj )  where  u * = 
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Wave  stress  for  the  y-momentum  equation  is  given  by: 
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Bottom-friction  coefficient 

/  \  fa 

The  bottom- friction  coefficient  \Cb).  .  is  given  by: 
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where  Qj  =  Chezy  coefficient  calculated  as: 
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where  Rf  .  =  hydraulic  radius,  which  is  dependent  on  the  cell  dimension  As ,  in 
the  corresponding  flow  direction. 


The  hydraulic  radius  for  a  given  cell  is  calculated  by: 

,  d* 


(138) 


where  d =  cell-face  averaged  depth,  Pitj  =  wetted  perimeter  of  the  cell,  and  As1 

denotes  Ay  or  Ax:  for  application  of  Equation  138  to  the  x-  or  y-momentum 
equation,  respectively.  For  the  x-momentum  equation,  the  cell-face  averaged 
depth  is  calculated  as: 


d*  = 


(A‘,J+n‘,J)+(*,W4 


(139) 


and  for  the  y-momentum  equation,  the  cell-face  averaged  depth  is  calculated  by: 


c=- 


(140) 
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The  wetted  perimeter  is  taken  to  be  equal  to  As  if  a  cell  has  no  impermeable 
walls.  If  walls  are  present,  the  wetted  perimeter  is  calculated  by: 


(141) 

where  m  =  number  of  wall  boundaries  on  sides  parallel  to  the  direction  of  flow 
for  the  momentum  equation  being  solved.  The  total  number  of  wall  boundaries 
includes  those  corresponding  to  cell  ij  and  cell  i-lj  if  the  x-momentum  equation 
is  being  solved,  or  cell  ij- 1  if  the  y-momentum  equation  is  being  solved.  For 
example,  in  the  situation  of  flow  along  a  one-cell- wide  channel  adjacent  to  land 
and  aligned  with  the  x-axis,  the  wetted  perimeter  would  be  calculated  as 

P  =  Ay  +  2d.j  at  all  cells  in  the  channel.  The  formulation  of  the  bottom- friction 

coefficient  takes  into  account  wall  friction,  but  does  not  distinguish  it  from 
friction  along  the  channel  bottom. 


Inclusion  of  waves  in  the  bottom  stress  is  implemented  by  representing  the 
combined  wave  and  current  terms  of  Equations  1 1  and  12,  respectively,  as: 
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Because  the  wave  properties  are  scalar  values,  they  are  located  at  cell  centers  and 
are  face-averaged  for  application  in  the  bottom  stress  calculation. 


If  water  in  a  cell  approaches  a  thin  layer,  numerical  instability  may  arise  and 
unrealistically  large  values  of  water  level  and  current  speed  calculated.  In  a  real 
system,  water  encroaching  onto  a  dry  surface  is  expected  to  experience  large 
frictional  resistance.  Stability  in  shallow  water  is  enhanced  within  CMS-M2D  by 
adjustment  of  the  bottom- friction  coefficient  by  the  following  formulation: 

..  =(c4-j(1+exp' ~ad‘J)  (156) 

where  the  subscript  adjusted  denotes  the  modified  bottom- friction  coefficient, 
and  a  is  a  parameter  that  controls  the  gradient  of  the  increase  of  the  bottom- 
friction  coefficient  as  the  water  depth  approaches  zero.  The  bottom-friction 
coefficient  can  vary  within  the  range  Cb  to  2 Cb ,  with  the  adjustment  scaled  by 
the  exponential  expression  given  within  Equation  156. 


(cb) 


adjusted 
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Figure  9  shows  the  depth-dependent  adjustment  of  the  bottom-friction 
coefficient  as  given  by  the  exponential  formulation  with  the  parameter  a  set  to 
10.  Significant  increases  in  the  bottom- friction  coefficient  occur  for  small  water 
depth,  particularly  less  than  0.1  m  because  of  the  presence  of  large  roughness 
elements  relative  to  the  water  depth.  Thus,  modification  of  the  bottom-friction 
coefficient  from  its  normal  value  is  restricted  to  small  water  depth.  For  depths 
greater  than  approximately  0.2  m,  modification  of  the  bottom-friction  coefficient 
is  small. 


Depth,  m 


Figure  9.  Bottom-friction  coefficient  adjustment  versus  total  water  depth 


Wind  stress 


Wind-stress  terms  are 

calculated  by: 
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where  Q  is  calculated  by  Equation  31,  and  WXQ  is  calculated  from  W.  The 
density  ratio  pa  /  pw  is  specified  as  0.0012.  Height  of  the  anemometer  is 

specified  in  an  input  file.  Wind  forcing  in  CMS-M2D  can  vary  over  time,  but  is 
homogenous  over  space  because  of  anticipated  local-  or  project-level  application. 
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Eddy  viscosity  coefficient 


Two  formulations  for  calculation  of  the  eddy  viscosity  coefficient  are 
implemented  in  CMS-M2D,  one  for  oceanic  mixing  and  one  for  surf  zone 
mixing.  If  waves  are  not  present,  the  oceanic  coefficient  of  eddy  viscosity  is 
calculated  as: 
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These  formulations  are  calculated  for  Manning’s  n  >  0.  For  frictionless  cells, 
specified  by  n  =  0  ,  withD0  =  0.0  . 


In  the  presence  of  waves  and  wave  breaking,  the  eddy  viscosity  coefficient  is 
calculated  as: 
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Wavelength  X  is  calculated  by  the  Eckart  (1952)  approximation: 
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where  A,0  =  deepwater  wavelength  given  by: 


(170) 


and  co  is  the  wave  frequency  given  by: 


Wave  parameters  are  calculated  at  locations  corresponding  to  indices  on  Dw 


(171) 


(172) 


If  waves  are  present,  but  not  breaking,  then  the  mixing  coefficient  is 
calculated  as  a  weighted  function  of  the  oceanic  and  wave  mixing  values  as: 

Dk  ={\-tf)(D0)k (Dj  (173) 

where  the  weighting  parameter  0  is: 


e* 


6  Ht  V 


hk  +rj 


(174) 


Equations  173  and  174  are  calculated  and  applied  at  locations  corresponding  to 
indices  on  D0  and  Dw. 
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Wave  stress  scaling  for  shallow  water 


CMS-M2D  accepts  wave  stresses  calculated  by  a  wave  model,  and  those 
stresses  can  vary  spatially  and  temporally  over  the  computational  domain.  Wave 
stresses  must  be  mapped  from  the  wave  model  onto  the  CMS-M2D  domain,  and 
those  stresses  are  computed  for  water  depths  provided  to  the  wave  model.  Wave 
properties  are  typically  updated  over  time  intervals  of  hours,  during  which  water 
levels  can  rise  and  fall  owing  to  the  tide,  storm  surge,  and  wind  forcing.  During 
a  CMS-M2D  simulation,  the  total  water  depth  will  vary  as  a  function  of  the  total 
forcing.  If  the  water  level  decreases,  the  wave  stresses  can  contribute 
disproportionately  to  the  velocity,  particularly  in  shallow  water  because  the  wave 
stresses  are  not  updated  by  the  wave  model  at  every  time  step.  For  example,  the 
water  depth  at  a  specific  location  may  be  0.5  m  for  the  wave  calculations  and  at 
the  beginning  of  a  CMS-M2D  simulation.  During  the  CMS-M2D  simulation,  the 
water  level  lowers  to  0.05  m,  but  the  wave  stress  value  was  calculated  for  0.5  m 
and  may  be  significantly  larger  than  it  would  be  for  a  depth  of  0.05  m.  Thus,  an 
ad  hoc  scaling  factor  has  been  implemented  to  adjust  the  wave  stresses  in  shallow 
water.  This  scaling  factor  reduces  the  wave  stress  in  shallow  water  depths  to 
maintain  realistic  velocities  and  to  promote  stability.  In  water  depths  of  0.35  m 
or  less,  the  wave  stresses  are  reduced  by: 


^s=^s 


0.35 


for  (h^j  H-rifj)  <  0.35m 


(175) 


where  Ts  =  adjusted  wave  stress  and  is  applied  to  both  TSx  and  TSy  if  the  depth 

criterion  is  met.  Equation  175  scales  the  wave  stress  toward  zero  as  the  water 
depth  decreases. 


Wave  models  typically  perform  calculations  in  a  local  right-handed 
coordinate  system  in  which  positive  x  is  directed  onshore  and  positive  y  is 
directed  alongshore.  Thus,  the  orientation  of  the  local  coordinate  system  may  not 
be  aligned  with  global  geographic  coordinates.  CMS-M2D  performs  calculations 
on  a  local  coordinate  system  that  is  referenced  to  global  geographic  coordinates 
by  the  deviation  of  the  y-axis  (given  in  degrees)  from  tme  north.  If  wave  stresses 
are  included  in  CMS-M2D  calculations,  mapping  of  those  stresses  from  the  wave 
model  to  the  circulation  model  must  take  into  consideration  the  different 
coordinate  systems  and  grid  orientations.  Wave  stresses  calculated  by  STWAVE 
or  WABED  can  be  automatically  mapped  to  CMS-M2D  within  the  SMS  (see 
Chapter  8). 


Continuity  Equation 

The  continuity  equation  is  solved  explicitly  for  water-surface  elevation  T|  by 
a  finite-volume  approximation  for  a  control  volume  depicted  in  Figure  10.  Mass 
fluxes  are  approximated  at  each  cell  face.  In  the  staggered  time  differencing 
scheme,  the  most  recently  calculated  values  for  the  u  and  v  velocity  components 
are  entered  into  the  spatial  derivatives.  The  finite-volume  approximation  of 
Equation  1  is  given  by: 
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Figure  10.  Control  volume  definition  for  continuity  equation 

Cell  Numbering 

CMS-M2D  stores  its  numerical  grid  in  an  array  rather  than  a  matrix,  which 
saves  memory  for  large  or  irregular  grid  domains.  The  numbering  scheme  for  the 
computational  grid  is  designed  to  be  efficient  such  that  cells  that  reside  in 
computationally  inactive  regions  do  not  have  to  be  stored.  For  model  domains 
that  have  complex  shorelines,  this  feature  can  save  substantial  computer  memory. 
On  the  other  hand,  for  simple  grids,  more  memory  may  be  required  because 
pointing  arrays  are  necessary  for  cell  indexing. 

The  cell  numbering  system  internal  to  CMS-M2D  does  not  require  row  and 
column  indexing,  but  instead  assigns  each  cell  a  unique  identification  number. 
Flather  and  Heaps  (1975)  implemented  a  similar  cell  numbering  system  so  that 
only  cells  included  in  hydrodynamic  calculations  were  stored.  Non- 
computational  regions  of  the  grid,  such  as  the  mainland  and  islands,  do  not 
require  assigned  cell  numbers,  so  they  do  not  occupy  space  in  memory. 

Figure  1 1  illustrates  the  cell  numbering  system  for  a  small  domain  that  includes  a 
non-computational  region  indicated  by  hatching.  Cell  identification  numbers  of 
neighbors  adjacent  to  a  particular  cell  are  stored  in  a  pointing  matrix  within  the 
model.  For  example,  cell  9  has  neighbors,  with  cell  identification  numbers  12, 

10,  4,  and  8  moving  from  top,  to  right,  bottom,  and  left,  respectively.  This 
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clockwise  order  of  referencing  neighbor  cells  is  taken  as  convention  for 
descriptions  in  this  document. 
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Figure  1 1 .  Cell  numbering  system 


Locations  where  no  cells  exist,  such  as  beyond  the  computational  domain  or 
in  non-computational  regions  such  as  islands  within  the  domain,  are  not  stored  in 
the  grid  as  cells,  but  can  be  referenced  as  having  a  cell  identification  number  of 
0.  For  example,  cell  1 1  in  Figure  1 1  lies  on  the  boundary  of  the  grid  domain  and 
also  resides  next  to  a  non-computational  area.  Neighbor-cell  specifications  for 
cell  1 1  would  be  stored  as  14,  0,  6,  and  0.  The  grid  does  not  contain  any  cells 
with  a  cell  number  of  zero;  this  value  is  used  in  neighbor  specification  to  indicate 
that  a  computational  cell  does  not  exist  at  a  particular  location. 


Courant  Condition 


For  an  explicit  solution  method,  an  initial  estimate  of  the  maximum  time  step 
for  a  grid  can  be  calculated  from  the  Courant  number  given  by  (Richtmyer  and 
Morton  1967): 


^  =  u 


A t_ 
As 


(177) 


The  theoretical  maximum  value  of  the  Courant  number  is  unity  for  stability  of  a 
linear,  finite-volume  hydrodynamic  model,  in  which  for  shallow-water  equations 

u  ~  sigh  refers  to  the  speed  of  a  long  wave,  such  as  the  tide.  For  a  fixed  As 
and  u ,  the  Courant  number  limits  the  value  of  the  hydrodynamic  time  step  At . 
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Because  CMS-M2D  solves  the  nonlinear  shallow-water  equations,  stability 
will  be  maintained  for  a  Courant  number  less  than  unity.  Also,  for  a  typical 
coastal  inlet  situation,  multiple  forcing  is  possible  from  a  superposition  of 
sources  other  than  or  in  addition  to  the  tide.  Contributions  to  the  current  can  be 
produced  by  wind,  surface  waves,  and  tributary  discharges.  Assigning  a  velocity 
component  to  each  of  these  forcings,  denoted  with  a  subscript,  the  Courant 
number  is  more  accurately  defined  as: 


+  u 


wind 


^  waves  ^ tributary  ) 


At_ 

As 


(178) 


In  strong  or  focused- flow  regions  of  a  model  domain,  such  as  at  ebb  shoals 
and  in  the  surf  zone,  the  wave-driven  current  can  be  significantly  stronger  than 
the  tidal  current.  Moreover,  these  are  typically  areas  of  greater  spatial  grid 
resolution.  The  combination  of  strong  currents  and  small  grid  cells  limits  the 
allowable  size  of  the  time  step  in  an  explicit  solution  scheme. 
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5  Numerical  Implementation 
of  Governing  Equations  for 
Sediment  Motion 


Three  choices  are  available  for  computing  sediment  transport  with  CMS- 
M2D:  the  Watanabe  (1987)  formulation,  the  Lund-CIRP  formula  (Camenen  and 
Larson  2005,  2006),  and  the  AD  equation.  The  Watanabe  transport  formula 
produces  a  total  transport  rate,  estimating  the  contributions  of  combined 
suspended  sediment  load  and  total  load  in  a  “calculation-at-a-point”  formulation. 
The  Lund-CIRP  transport  formula  computes  both  bed  load  and  suspended  load 
transport  rates,  which  are  combined  to  obtain  a  total  load  transport  rate.  The  AD 
equation  is  solved  for  both  suspended  load  and  bed  load  transport  rates. 

Morphology  change  is  computed  by  means  of  two  time  steps,  a  transport  rate 
time  step  and  a  morphology  change  time  step.  Instantaneous  transport  rates  are 
computed  at  the  transport  rate  time  step  and  averaged  over  the  morphology 
change  time  step.  Averaged  transport  rates  are  then  applied  in  the  sediment 
continuity  equation.  Transport  rates  calculated  by  the  Watanabe,  Lund-CIRP 
total  load  formula,  and  AD  equation  are  instantaneous  values. 


Watanabe  Formulation 


Implementation  of  the  Watanabe  formulation  computes  transport  rates  on  cell 
faces  with  the  x-directed  rate  qtot  x  located  on  the  left  face  center  and  the  y- 

directed  rate  qtot  located  on  the  bottom  face  center.  Thus,  for  a  given  cell, 

qtot  x  and  qtot  y  are  calculated  at  the  same  locations  as  u  and  v,  respectively 

(Figure  6).  Time-averaged  face-centered  transport  rates  are  applied  in  the 
sediment  continuity  equation  to  calculated  depth  change. 


Calculation  of  x-  and  y-directed  transport  rates  qtot  x  and  qtot  ,  respectively, 
by  the  Watanabe  formulation  is  conducted  in  CMS-M2D  as: 


tot,xij 


Qtotj’i 


=  A 


=  A 


x  -x 

b,X:  ,  Cl 


TV  -T 

b>yu  ci 


hj 


(179) 

(180) 
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The  bottom  stresses  in  the  situation  in  which  no  waves  are  present  are 
calculated  in  the  x  and  y  directions  as: 


%,Xt. 


=  -p  fk  (lf*f 

Q^WJ  C,Xi  j  \  l,J  ) 


(181) 


and 


ik  =Ip  fk  ( v*.)k 

b^i,j  Q  r  W*/  c^i  j  \  1,J  ) 


(182) 


in  which  the  velocities  ( U*  j  j  and  ( V*  )  are  calculated  as: 


•  ^  *  ,  Vi-l,j+l  +  Vi,j+l  +  Vi-l,j  +  VU 


K)  =Kj+ 


(183) 


and 


r* .)  —vk 

hj ) 


+  - 


(184) 


The  current  friction  factors  for  the  x  and  y  directions,  respectively,  are: 

,  S  0.5  ( hk , ,  +  rjf .  ,  +  hk ,  +  T|f . ) ^ 

ck  A  O /I  1  o  \  !>i  1  *l’J  1  l’J  *l’J  / 


fU,  =0.24  log- 
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and 
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12 


+<4’ 


(186) 


If  waves  are  present,  the  bottom  shear  stresses  in  the  x  and  y  directions  are 
calculated  as: 


x:  =  j  \xk  +  %k  cos 

b, max,x,- ,•  \j  \  m,xt w,xt  j 


.>(<)) 


(187) 


and 


^Z>,max,jA  •  \l[^m,yi  j  ^w,yt  ,  C0S 


«,))  +(<*M<,)) 


(188) 


Bottom  shear  stresses  calculated  by  Equations  187  and  188  are  entered  as  values 
of  Tkbx  and  Tkhy  in  Equations  179  and  180,  respectively. 


Combined  wave  and  current  shear  stresses  for  the  x  and  y  directions  are 
given  by: 
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(189) 
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(190) 


by: 


The  wave  bed  shear  stresses  for  the  x  and  y  directions,  respectively,  are  given 


x  =  0.5p  f  u 

W,Xt  ;  r  wJ  W,X;  ; 


and 


',xt  ■  W,x^ 


x*  =  0.5p  fk  u2 
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(191) 


(192) 


where  the  wave  friction  factor  for  the  x  direction  is  given  as: 


5-5  M? 


-6.3 


f  —e 

J  W,Xfj 

and  for  the  y  direction  is: 


(193) 
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Relative  roughness  for  the  x  and  y  directions  are  given  by: 


uk  T. 
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W,X,J  l,J 


2nk, 
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and 


uk  Tk. 
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Wave  orbital  velocity  amplitudes  for  the  x  and  y  directions,  respectively,  for 
non-breaking  waves  are: 


u  = 

W,X:  : 


2 T.  .  sinh 


n(HUj+K)^ 


Kj 


(197) 


and 


58 


Chapter  5  Numerical  Implementation  of  Governing  Equations  for  Sediment  Motion 


(198) 


*(HIh+HD 


2 T.j  sinh 


Kj 
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For  breaking  waves,  the  wave  orbital  velocity  amplitudes  for  the  x  and  y 
directions,  respectively,  are: 


u  = 

W,X:  : 
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Lund-CIRP  Formulation 

The  Lund-CIRP  formulation  computes  sediment  transport  properties  and 
transport  rates  at  the  cell  center,  which  corresponds  to  the  same  location  in  the 
cell  as  the  water-surface  elevation  T|  is  calculated  (Figure  6).  After  transport 
rates  are  calculated  by  the  Lund-CIRP  formulas  for  all  cells  in  the  domain,  they 
are  mapped  back  to  the  cell  faces  such  that  the  x-directed  rate  qtot  x  is  located  on 

the  left  face  center  and  the  y-directed  rate  qtot  is  located  on  the  bottom  face 

center.  Time-averaged  face-centered  transport  rates  are  applied  in  the  sediment 
continuity  equation  to  calculated  depth  change. 

AD  Equation 


AD  equation  for  sediment  concentration 


The  AD  equation  for  sediment  concentration  is  solved  explicitly  for  depth- 
averaged  concentration  by  a  finite-volume  approximation  for  a  control  volume. 
Depth-averaged  concentration  C,  pick-up  rate  P,  and  deposition  rate  D  are 
approximated  at  each  cell  center,  and  mass  fluxes  are  approximated  at  each  cell 
face.  The  finite-volume  approximation  of  Equation  79  is  given  by: 
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where 
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ACU  = 


s~ik+\  s-ik 

c Uj  ^ ij 


i,j  =  cell  location  on  the  grid 
k  =  time  step 

A tsed  =  time  step  to  calculate  sediment  transport 


Ay.  j  =  cell  side  length  parallel  to  the  x-axis 


Ay.  j  =  cell  side  length  parallel  to  the  y-axis 
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Pick-up  rate  and  deposition  rate 

Pick-up  rate  and  deposition  rate  can  be  calculated  in  CMS-M2D  by  either  the 
van  Rijn  or  Lund-CIRP  formulation.  The  calculation  method  of  P  and  D  for  van 
Rijn  formula  is  described  first,  then  that  for  Lund-CIRP  formula. 

Van  Rijn  model  (exponential  profile  or  van  Rijn  profile) 


The  pick-up  rate  P  and  for  van  Rijn  model  is  given  by: 
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Maximum  bottom  shear  stress  Ts>max  is  given  by: 
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where  rcs,  rws,  and  rms  are  shear  stresses  owing  to  current,  wave,  and  combined 
wave  and  current,  and  are  given  by: 
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The  current  velocity  and  wave  orbital  velocity  (a,  are  defined  at  each  cell 
center. 
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and  wave  friction  factor  is: 
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where 
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Calculations  with  CMS-M2D  have  shown  that  the  van  Rijn  (1985)  reference 
concentration  tends  to  give  an  overestimation  under  strong  shear  stress,  such  as 
in  the  sheet  flow  region.  Therefore,  the  following  limitation  is  applied  to  reduce 
the  overestimate: 
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where  R  is  the  reduction  coefficient  expressed  as: 


(216) 
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in  which  ch  is  the  extrapolated  bed  concentration  calculated  by  Equation  207  with 
a  =  <750,  which  reduces  to: 
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The  deposition  rate  D  for  the  van  Rijn  model  is  given  by: 
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where  $d  is  the  conversion  parameter  that  depends  on  the  user-selected 
concentration  profile.  If  an  exponential  profile  is  selected,  $d  is  calculated  by 
using  depth-averaged  mixing  coefficient  8cw  and  given  by: 
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and  the  reference  height  a  is  given  by: 
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where  Hr  is  the  ripple  height. 
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If  the  van  Rijn  profile  is  selected,  $d  has  to  be  calculated  numerically  because 
the  mixing  coefficient  varies  with  height  from  the  bed.  In  the  AD-model  with  the 
van  Rijn  profile,  the  mixing  coefficients  are  calculated  at  20  points  in  the  vertical 
direction.  Mixing  coefficients  for  the  current  8C  and  for  waves  8W  are  calculated, 
and  then  combined  as  follows: 
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With  the  mixing  coefficient  £cw(z)  available,  the  vertical  distribution  of  the 
concentration  c(z)  can  be  solved  by  the  fourth-order  Runge-Kutta  method.  Then, 
values  for  the  van  Rijn  profile  are  calculated  by  numerical  integration  of  the 
concentration  profile: 
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Lund-CIRP  model 


The  pick-up  rate  P  for  the  Lund-CIRP  model  is  given  by: 

where  r,  is  the  reference  concentration  given  by: 
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where  AcR  =  3.5  10"3exp(-0.3<7*),  and  b  =  4.5.  Bed  shear  stresses  due  to  current, 
wave,  and  combined  current  and  wave  are  given  by, 
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Friction  factors  for  the  current  and  for  waves  are  given,  respectively,  by: 
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The  deposition  rate  D  for  the  Lund-CIRP  model  is  given  by: 
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The  concentration  profile  for  the  Lund-CIRP  formula  is  approximated  by  an 
exponential  profile.  The  conversion  parameter  (3^  is  given  by: 
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where  the  mixing  coefficient  ecw  is  calculated  as: 
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De  is  the  energy  dissipation  rate  owing  to  current,  wave,  and  wave  breaking: 
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Dk .  =  klDk .  +  klD  k .  +  klDbk . 

eij  c  cij  w  cij  b  bij 

(240) 

D k .  =  x  k  .uk . 

Cl  ij  CIJ  *CIJ 

(241) 

k  k  k 

I J  —  T  u 

wij  wij  *wij 

(242) 

and  Db  is  given  from  wave  model  output,  and  u*c  =  ^/lc/pw  and 

U*w  ~  VTw/ Pu  • 


Sediment  diffusion  coefficient 


Diffusion  coefficients  Kx  and  are  defined  at  cell  faces  and  calculated  as: 


K:+V2j=  5.931 


=5-931 
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(244) 
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(245) 
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Bed  load  transport  rate 

Bed  load  transport  rates  qbX  and  <//,,  are  calculated  at  each  cell  center.  For  the 
van  Rijn  model,  they  are  given  by: 


QbxiJ  ~  0-1^50  ( U*c  \  j 
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where 


k  ,  k 
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Bed  load  transport  rates  for  the  Lund-CIRP  model  are  given  by: 
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(  \ 

QbyiJ  ~  anyJ^ciJ^cw,mi,j  eXP 

x 

b  c[ 

v  cvWj  J 

where  an  =  12  and  Z?  =  4.5. 

Boundary  conditions 

K, 


t/*. 


(252) 


Boundary  conditions  for  the  AD  equation  are  given  for  wall  boundary  and 
for  open  boundary,  respectively. 

If  a  cell  face  is  defined  as  a  wall,  the  suspended  load  flux  on  the  cell  face  is 
set  to  zero. 

Fi_l/2j=0  for  left  face  is  wall  boundary  (253) 
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F*m,j  ~  0 

for  right  face  is  wall  boundary 

(254) 

Gij-m  =  0 

for  top  face  is  wall  boundary 

(255) 

Gij+\n  =  0 

for  bottom  face  is  wall  boundary 

(256) 

For  the  cell  on  the  open/forcing  boundary,  the  concentration  is  set  as  the 
equilibrium  concentration, 

(257) 

where  Cf .  is  the  depth-averaged  concentration  on  the  open  boundary  cell, 
the  gradient  of  suspended  load  flux  is  set  as  zero  (dF  /dx  =  0  or  dG/dy  = 
the  open  boundary. 

Also, 

0)  for 

^i-\/2,j  ~  Fi+i/2 j 

for  left  face  is  open  boundary 

(258) 

F \+mj  ~  F \-M2j 

for  right  face  is  open  boundary 

(259) 

Qj- 1/2  =  Qj+ 1/2 

for  top  face  is  open  boundary 

(260) 

Gij#n  ~  Qj~  1/2 

for  bottom  face  is  open  boundary 

(261) 

Criterion  of  time  step  for  AD  model 

Calculation  of  the  AD  equation  is  computed  at  a  time  step  of  A tsed.  To 
maintain  stable  calculations  in  an  explicit  solution  scheme,  the  following 
condition  must  be  satisfied: 

^sed<\—  (262) 

1  u 

where  As  is  the  cell  size,  and  u  is  the  local  current  speed.  During  calculation  of 
the  AD  equation,  CMS-M2D  evaluates  whether  this  criterion  is  met.  If  the 
criterion  is  not  met,  CMS-M2D  will  reduce  A tsed  to  maintain  stability. 


Hard-bottom  methodology  for  AD  model 


Modification  of  sediment  transport  rate  owing  to  hard  bottom  is  also 
computed  in  the  AD  model.  Hard  bottom  is  treated  separately  for  suspended  and 
bed  load.  For  suspended  load,  the  methodology  assumes  that  upward  sediment 
flux  will  be  zero  if  the  hard  bottom  is  exposed.  The  criterion  for  the  maximum 
pick-up  rate  is  expressed  as: 


Pk.  < 

hj  ~ 


Kb,  j  \  j  k 

— ^ - -  +  Dkj 


pAt 


sed 


(263) 


where  hhb  is  the  hard-bottom  level,  and  p  is  the  porosity.  For  bed  load,  the 
methodology  of  treating  hard  bottom  as  described  in  Chapter  3  is  applied. 
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Sediment  Continuity  Equation 

Calculation  of  depth  change  is  computed  by  solution  of  the  sediment 
continuity  equation.  Before  solving  the  sediment  continuity  equation,  time- 
averaged  sediment  transport  rates  are  computed  from  the  instantaneous  transport 
rate  values.  Transport  rates  applied  in  the  sediment  continuity  calculations  are 
total  load  transport  rates  when  total  load  formulations  are  applied,  or  bed  load 
transport  rates  when  the  AD  equation  is  applied.  Thus,  for  the  sediment 
continuity  equation,  the  subscript  t  denotes  total  load  for  total  load  formulations 
and  bed  load  for  the  AD  equation. 

Time-averaged  transport  rates  for  the  x  and  y  directions,  respectively,  are 
computed  by: 
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(264) 

(265) 


in  which  Nm  =  number  of  instantaneous  transport  rate  values,  and  /  =  index 
representing  the  time  at  which  the  instantaneous  rates  were  calculated. 
Instantaneous  rates  are  calculated  at  the  sediment  transport  time  step  A tsed  ,  and 
time-averaged  rates  apply  instantaneous  rates  averaged  over  the  morphologic 
change  time  step  A tmorph .  Adjustment  of  the  time-averaged  transport  rate  for 

bottom  slope  is  computed  for  the  x  and y  directions  as: 
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where  the  total  time-averaged  transport  rates 
as: 
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(267) 

are  calculated 
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Depth  change  over  the  time  interval  A t} 


is  calculated  as: 


f— Y 

vA  t). 


morph 


1  1 


P g  (1  ~P) 


tot,xi+K 


_ 


tot,yi 


Ax, 


*y< j 


Updated  depth  is  then  computed  by: 


(270) 
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(271) 


After  new  depth  values  are  calculated  for  all  cells  in  the  computational  domain, 
they  are  provided  to  the  hydrodynamic  portion  of  the  model  so  that  it  can  respond 
to  changes  in  morphology. 


For  the  AD  model,  calculation  of  depth  change  is  computed  by  a  method 
similar  to  that  described  above,  except  that  suspended  load  and  bed  load 
components  are  treated  separately.  Before  solving  the  sediment  continuity 
equation,  time-averaged  sediment  transport  rates  are  computed  from  the 
instantaneous  transport  rate  values.  Time-averaged  pick-up  rate  and  deposition 
rate  for  the  suspended  load  component  are  computed  by: 
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Time-averaged  bed  load  transport  rates  for  the  x  and  y  directions,  respectively, 
are  computed  by: 
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Bed  load  transport  rates  for  the  AD  model  are  defined  at  each  cell  center. 
Solution  of  the  sediment  continuity  equation  requires  that  the  bed  load  transport 
rates  are  defined  at  the  centers  of  cell  faces.  Therefore,  bed  load  transport  rates 
are  computed  on  the  cell  faces  by: 


—  k  —  k 
—rk  _  qbxi,j  tfbxi-l, 

qbxiJ  ~  n. 


J 


_  £  _ 

-r  k  Q fyij  +  y^ij- 1 

- o - 


(276) 

(277) 


Chapter  5  Numerical  Implementation  of  Governing  Equations  for  Sediment  Motion 


Further,  adjustment  of  the  time-averaged  bed  load  rate  for  bottom  slope  is 
computed  for  the  x  and  y  directions  as: 
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Depth  change  over  the  time  interval  A t  h  is  calculated  as: 
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Updated  depth  is  then  computed  by  Equation  27 1 . 
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6  Boundary  Conditions 


Six  types  of  boundary  conditions  are  implemented  in  CMS-M2D  and  are 
distinguished  as  specifying  a  forcing  or  a  non-forcing  boundary.  Table  2  lists  the 
boundary  condition  types  and  contains  a  short  description  of  each.  Each 
boundary  condition  type  is  described  next. 


Table  2 

Boundary  Condition  Types 

Boundary  Condition 

Description 

Tidal-constituent  water-level  forcing 

Water  level  specified  as  sum  of  tidal  constituents 

Time  series  water-level  forcing 

Water  level  specified  from  time  series  input  file 

Time  series  water-level  and  velocity 
forcing 

Water  level  and  velocities  specified  from  time  series  input 
files 

Time  series  flow  rate  forcing 

Flow  rate  specified  from  a  time  series  input  file 

Closed,  reflective  (non-forcing) 

Impermeable  boundary,  velocity  must  flow  parallel  to 
boundary 

Wave-adjusted  water-level  and 
velocity  forcing 

Boundary  water  level  and  velocity  values  are  adjusted  for 
presence  of  radiation-stress  gradients.  Provides 
compatibility  of  boundary  forcing  with  wave  forcing 

Water-Level  Forcing  Boundary  Conditions 

Water-level  forcing  can  be  specified  through  either  tidal  constituents  or  by 
time  series  of  water  level  read  from  a  file.  These  two  boundary  conditions  apply 
the  same  calculation  approach,  with  the  distinguishing  feature  between  them 
being  the  source  of  the  water  level  prescribed  at  the  boundary. 

If  a  cell  is  designated  as  a  water-surface  elevation  boundary  cell,  the 
continuity  equation  for  that  cell  is  not  solved,  and  the  water  level  is  updated  each 
time  step  according  to: 

<;'=</  (28i) 


Chapter  6  Boundary  Conditions 


71 


where  T|* .  is  a  prescribed  value.  If  tidal  forcing  is  specified,  then 


<y  =  rl  tide 


(282) 


Tidal-constituent  forcing 


Tidal-constituent  forcing  in  CMS-M2D  can  accommodate  as  many  as  eight 
components  of  the  astronomical  tide.  The  user  can  select  from  the  following 
constituents:  M2,  S2,  N2,  K2,  Ki,  Oi,  M4,  and  M6.  Although  the  M4  and  M6 
constituents  are  harmonics,  they  can  be  generated  in  continental  shelf  areas  and 
may  be  present  as  components  of  the  tidal  forcing  at  the  grid  boundary. 
Specification  of  tidal  constituents  requires  input  information  for  the  local 
amplitude  and  phase  values.  Tidal-constituent  forcing  by  CMS-M2D  is  simple 
and  does  not  include  advanced  tidal  calculations  or  relations  to  Greenwich  tidal 
parameters  (Schureman  1924). 

Tidal  elevation  V\tide  is  given  by: 


cos 


360 W  lj 


(283) 


where  A  =  amplitude  (m),  5  =  speed  (deg/hour),  and  <\>  =  phase  (deg)  of  the  tidal 
constituent.  Constituents  can  be  eliminated  from  the  tidal  forcing  by  setting  their 
amplitudes  to  zero.  If  the  tidal  elevation  boundary  condition  is  invoked,  water 
levels  at  tidal  boundary  cells  are  computed  at  every  time  step.  Tidal  phase  and 
amplitude  is  held  constant  across  the  tidal-constituent  boundary.  For  applications 
requiring  amplitude  and  phase  variation  over  an  open  boundary,  two  approaches 
to  forcing  the  boundary  are  available.  Time  series  of  tidal  curves  along  the 
boundary  can  be  developed  within  the  SMS  in  which  the  tidal  information  is 
obtained  from  a  tidal-constituent  database.  Alternatively,  solutions  from  regional 
models  can  be  applied  to  map  water-surface  elevations  as  boundary  conditions 
for  CMS-M2D. 


Time  series  water-level  forcing 

The  time  series  water-level  forcing  boundary  condition  is  specified  by  water 
levels  (T|^ . )  read  into  the  model  from  an  input  file.  Time  increments  of  the 

forcing  data  are  not  required  to  be  equal  to,  or  in  multiple  increments  of,  the 
model  time  step.  Because  the  model  will  usually  have  a  hydrodynamic  time  step 
smaller  than  the  time  interval  between  water-level  forcing  input,  CMS-M2D 
must  be  instructed  on  treatment  of  the  water-level  boundary  value  between  times 
that  its  value  is  specified  in  the  input  file.  One  option  is  to  linearly  interpolate  in 
time  between  input  water-level  values,  and  this  is  the  preferred  option.  A  second 
option  is  to  keep  the  water  level  constant  between  input  water-level  values.  The 
boundary  condition  input  file  for  water  level  contains  a  parameter  that  sets  the 
interpolation  option. 
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Time  Series  Water-Level  and  Velocity  Forcing 
Boundary  Condition 

The  time  series  water-level  and  velocity  forcing  boundary  condition  applies 
velocities  at  cell  boundaries  in  addition  to  water  levels.  Application  of  water 
levels  for  this  boundary  type  is  identical  to  that  previously  described  for  water- 
level  forcing  boundary  conditions.  Velocities  prescribed  on  the  boundaries  enter 
the  momentum  equation  through  the  advective  terms.  Discretization  of  the 
momentum  equations  for  applying  velocities  on  the  boundaries  is  identical  to  the 
implementation  for  non-boundary  cells  described  in  Chapter  4. 


Time  Series  Flow  Rate  Forcing  Boundary 
Condition 


The  time  series  flow  rate  forcing  boundary  condition  can  be  assigned  at 
locations  where  the  flow  rate  is  known.  Typical  examples  where  this  boundary 
condition  is  applied  are  natural  tributaries  (rivers,  streams,  and  creeks), 
controlled-discharge  canals,  and  anthropogenic  intake  or  discharge  locations  such 
as  for  power  plant  cooling  water  or  treatment  plant  outfalls. 

A  flow  rate  boundary  condition  specifies  discharge  at  one  or  more  cells  on 
the  grid  boundary.  If  a  cell  is  designated  as  a  flow  rate  boundary  cell,  the 
momentum  equation  for  the  appropriate  cell  face  is  not  solved,  and  the  flow- 
component  normal  to  the  face  is  prescribed.  Because  CMS-M2D  operates  on  a 
staggered  grid,  virtual  cells  are  added  to  the  right  or  top  of  the  grid  at  flow  rate 
forcing  boundary  cells  prescribed  on  those  sides.  Addition  of  virtual  cells,  where 
water-surface  elevation  and  current  are  not  calculated,  is  required  to  calculate 
fluxes  at  cell  faces  on  the  right  or  top  of  the  grid. 

For  a  flow  rate  forcing  cell  located  on  the  right  side  of  the  grid  at  location 
/+ 1,/,  the  flux  is  given  by: 


(284) 


where  Qbx  i  =  input  flow  rate  directed  parallel  to  the  x-axis,  and  i  + 1  denotes  an 
imaginary  cell  adjacent  and  to  the  right  of  the  ith  cell. 


For  a  flow  rate  forcing  cell  located  on  the  left  side  of  the  grid  at  location 
i-lj,  the  flux  is  given  by: 
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For  a  flow  rate  forcing  cell  located  on  the  top  side  of  the  grid  at  location 
ij+ 1,  the  flux  is  given  by: 
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where  Qby  =  input  flow  rate  directed  parallel  to  the  y-axis. 


For  a  flow  rate  forcing  cell  located  on  the  bottom  side  of  the  grid  at  location 
ij- 1 ,  the  flux  is  given  by: 
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(287) 


Closed,  Reflective  Boundary  Condition 

The  closed,  reflective  boundary  condition  is  specified  at  impermeable 
boundaries,  such  as  at  the  land-water  interface.  These  boundaries  behave  as 
walls;  water  can  flow  parallel  to  the  wall  face,  but  not  through  it. 

The  normal  velocity  at  a  closed  boundary  on  the  left  cell  face  is: 

uj}1  =  0  (288) 

and  the  normal  velocity  at  a  closed  boundary  on  the  bottom  face  is: 

v*f  =  0  (289) 

Closed  boundaries  on  the  right  and  top  cell  faces  are  prescribed  at  the  imaginary 
cells  /+ 1 J  and  ij+ 1,  respectively. 


Wave-Adjusted  Water-Level  and  Velocity  Forcing 

Simulations  for  nearshore  areas  may  have  available  boundary  forcing 
information  that  does  not  include  the  presence  of  waves.  The  wave-adjusted 
water-level  and  velocity  boundary  condition  modifies  the  prescribed  forcing 
values  to  account  for  waves.  If  water-level  forcing  or  mixed  water-level  and 
velocity  forcing  are  applied  together  with  radiation-stress  forcing,  then  in  this 
boundary  condition,  boundary  values  are  adjusted  for  wave-driven  current  and 
set  up  or  set  down.  Boundary  adjustment  is  conducted  by  creating  a  surface 
deflection  (set  up  and  set  down)  consistent  with  that  of  the  interior  solution  so 
that  radiation  stress-forced  flow  can  move  smoothly  through  the  boundary  (Reed 
and  Militello  2005).  It  is  believed  that  this  boundary  condition  is  new  to  coastal 
circulation  modeling. 

Implementation  of  the  wave-adjusted  boundary  conditions  within  CMS-M2D 
is  automated.  Thus,  if  radiation-stress  gradients  are  applied  as  forcing,  CMS- 
M2D  will  automatically  apply  the  wave-adjusted  boundary  condition  to  adjust 
the  prescribed  forcing  for  the  presence  of  waves. 

Adjustment  to  the  prescribed  boundary  conditions  is  conducted  by  solving 
the  ID  continuity  and  momentum  equations  normal  to  the  boundary,  in  which  the 
radiation  stress  gradient  is  included  in  the  momentum  equation.  The  forms  of  the 
ID  continuity  and  momentum  equations  for  the  x-direction  are: 
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(290) 
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in  which: 


(291) 


T1  =  T1*+Ti'  (292) 

where  r\  is  the  applied  boundary  condition,  T|^  is  the  prescribed  boundary  value 
(read  from  a  file),  rfand  u  are  the  solutions  from  Equations  290  and  291,  and 
Qx  is  given  by: 


Qx=u' (h(x)  +  r T(x)) 


(293) 


where  h  (x)  and  T\  (x)  denote  face-centered  averages  that  place  h  and  T|  at  the 

same  position  as  u  .  If  the  boundary  is  specified  a  mixed  water-surface  elevation 
and  velocity  boundary,  then  the  ^-component  of  velocity  assigned  at  the 
boundary  is  modified  by: 


u-ub+u  (294) 

where  u  is  the  applied  velocity  at  the  boundary  and  ub  is  the  prescribed  velocity 
(read  from  a  file). 


The  ID  continuity  and  momentum  equations  for  the  y-direction  are: 
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(296) 


dt  dy  2  dy 

where  T)’  and  v  are  the  solutions  from  Equations  295  and  296,  and  O  is  given 
by: 


Q>y=v(h(y)  +  v;(y ))  (297) 

where  h  (7)  and  rj  (7)  are  face-centered  averages  that  place  h  and  T|  at  the 

same  position  as  v  .  If  the  boundary  is  specified  as  a  mixed  water-surface 
elevation  and  velocity  boundary,  then  the  v  component  of  velocity  assigned  at  the 
boundary  is  modified  by: 

v  =  v^+v'  (298) 
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where  v  is  the  applied  velocity  at  the  boundary  and  vb  is  the  prescribed  velocity 
(read  from  a  file). 

The  wave-adjusted  boundary  condition  is  demonstrated  in  Appendix  G  for  an 
idealized  beach. 
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7  Model  Features 


Capabilities  have  been  implemented  into  CMS-M2D  to  represent  flooding 
and  drying,  and  other  features  designed  to  promote  flexibility  and  convenience  of 
the  modeling  system.  This  chapter  describes  these  features  and  provides 
information  on  model  options.  Topics  covered  are:  flooding  and  drying,  hot- 
start  options,  model  spin-up,  coupling  with  larger  scale  circulation  models, 
coupling  with  wave  models,  and  output  options. 

Flooding  and  Drying 

Numerical  modeling  of  shallow-water  areas  such  as  beaches,  flood  shoals,  or 
expansive  tidal  or  wind-tidal  flats  is  most  accurately  performed  if  realistic  and 
robust  flooding  and  drying  algorithms  are  invoked.  Representation  of  flooding 
and  drying  also  eliminates  the  need  to  modify  grid  depth  to  avoid  artificially 
induced  instabilities.  Numerical  simulation  of  flooding  and  drying  of  cells  or 
elements  in  hydrodynamic  models  has  been  performed  with  various  techniques 
such  as  application  of  barrier  and  weir  equations  (Reid  and  Bodine  1968;  Butler 
1978;  Wanstrath  1978)  and  moving  boundaries  (Yeh  and  Chou  1978).  A  simple 
and  robust  flooding  and  drying  algorithm  has  been  implemented  to  represent 
inundation  and  drying  of  shallow  areas  of  the  model  domain. 

Criteria  were  established  for  the  flooding  and  drying  algorithms  implemented 
in  CMS-M2D  and  are  given  in  Table  3.  The  criteria  were  specified  so  that  the 
algorithms  would  produce  realistic  behavior,  and  numerical  problems,  such  as 
oscillations  and  flutter,  would  be  minimized. 


Table  3 

Criteria  for  Flooding  and  Drying  Algorithms 

Flooding 

Comments 

Water  depth  must  exceed  a  specified  minimum  depth 

Transfer  of  physically  meaningful  water 
volume,  avoids  flutter 

Water  must  be  moving  toward  dry  cell 

Takes  into  account  wind-induced  set  up, 
avoids  instability 

Drying 

Comments 

Total  water  depth  is  less  than  specified  minimum  depth 

Definition  of  drying 
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Every  wet  cell  is  checked  to  determine  whether  or  not  it  has  dried  after  new 
water-level  and  velocity  values  have  been  calculated  over  the  model  domain. 

The  criterion  for  a  cell  to  be  dry  is: 

‘>,j=K,+1 i.jS'C  <2») 

where  dt  .  =  total  water  depth,  and  dcr  =  depth  below  which  drying  is  assumed 

to  occur.  If  a  cell  or  its  adjacent  neighbor  to  the  south  or  west  has  become  dry, 
restrictions  on  flow  between  the  two  cells  are  imposed.  Restrictions  governing 
flow  across  the  two  faces  are  imposed  for  the  following  conditions: 


a .  Both  cells  on  each  side  of  a  face  are  dry. 
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This  restriction  sets  the  velocity  at  the  face  to  zero  so  that  there  is  no  transfer  of 
water  between  dry  cells. 


b.  Neighbor  to  south  or  west  is  dry,  and  cell  i,j  is  wet. 
dj  j  >  dcr  and  d{_X  J  <  dcr  and  u.j  >  0,  ufj  =  u.j  =  0 

di,j  >  dcr  and  dUj_x  <  dcr  and  v*y  >  0,  v*y  =  v g1  =  0 


(302) 

(303) 


This  restriction  sets  the  velocity  at  the  face  to  zero  if  the  velocity  at  the  previous 
time  step  indicates  transfer  of  water  from  a  neighboring  dry  cell  to  the  wet  cell 
ij.  Water  is  allowed  to  flow  from  the  wet  cell  to  the  neighboring  dry  cell. 


c.  Neighbor  to  south  or  west  is  wet,  and  cell  ij  is  dry. 


d —  dcr  di_X  j  >  dcr  and  ui  j  <  0,  utj  ui  j  0 


dij  -  d cr  and  dt  j_,  >  dcr  and  <  0,  vkt  j  =  vf  f  =  0 


(304) 

(305) 


This  restriction  sets  the  velocity  at  the  face  to  zero  if  the  velocity  at  the  previous 
time  step  indicates  transfer  of  water  from  dry  cell  ij  a  neighboring  wet  cell. 
Water  is  allowed  to  flow  from  the  neighboring  wet  cell  to  the  dry  cell  ij. 


Hot-Start  Capabilities 

CMS-M2D  has  two  hot-start  capabilities,  and  both  can  be  invoked  during  a 
simulation.  The  two  hot-start  types  are: 

a.  Hot-start  file  written  once  during  a  simulation  at  a  user-specified  time. 
The  file  name  prefix  is  given  by  the  user.  This  file  can  be  opened  in 
future  simulations  to  initialize  CMS-M2D  at  a  convenient  time,  such  as 
after  the  model  has  spun  up. 
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b.  Hot-start  file  written  at  user-specified  intervals.  If  this  option  is  invoked, 
CMS-M2D  will  alternate  hot-start  file  names  HOTSTART1.M2I  and 
HOTSTART2.M2I  each  time  a  hot-start  file  is  written.  An  information 
file  called  HOTSTART.INFO  is  also  written  that  contains  the  name  of 
the  last  hot-start  file  that  was  written  and  the  simulation  time,  in  hours, 
when  the  hot-start  file  was  saved.  These  hot-start  files  are  helpful  in 
restarting  simulations  that  terminate  unexpectedly. 


Model  Spin-Up:  Ramp  Function 

Model  spin-up  is  controlled  by  a  hyperbolic  tangent  function  that  scales 
values  of  the  input  forcing  over  a  user-specified  interval.  A  time-dependent 
scaling  factor  f  is  computed  as: 


fr, 


ramp 


■■  tanh 


4.5 - 

T 

\  ramp  J 


(306) 


where  Tmmp  =  time  over  which  the  model  is  spun  up.  All  model  forcing  is 
multiplied  by  the  scaling  factor  over  the  duration  of  the  ramp.  After  the 
simulation  time  exceeds  the  ramp  duration,  the  scaling  factor  is  set  to  1.0. 


Coupling  with  Larger-Domain  Model 

CMS-M2D  can  be  operated  as  a  detailed  inset  of  a  larger-domain  model. 

This  capability  maintains  hydrodynamic  properties  at  the  CMS-M2D  boundaries, 
increases  flexibility  in  resolution  over  the  project  area,  and  allows  for  application 
of  options  within  CMS-M2D  that  may  not  be  available  in  other  models. 

Coupling  can  be  invoked  by  forcing  CMS-M2D  with  water-surface  elevations  or 
a  combination  of  water-surface  elevations  and  velocities,  where  the  values  have 
been  obtained  from  a  larger-domain  model.  The  SMS  provides  an  automated 
procedure  for  extracting  and  mapping  boundary  information  from  a  larger- 
domain  model  to  CMS-M2D  (Chapter  8). 

CMS-M2D  can  accept  boundary  information  from  any  larger-domain  model, 
including  another  CMS-M2D  simulation.  Considerations  for  coupling  with  a 
larger-domain  model  are  discussed  here  with  an  example  shown  for  CMS-M2D 
forced  by  water-surface  elevations  and  velocities  calculated  by  ADCIRC.  If  a 
larger-domain  model  is  to  provide  boundary  conditions  for  CMS-M2D,  mesh  or 
grid  resolution  of  the  larger-domain  model  in  the  area  of  the  CMS-M2D 
boundary  must  be  sufficient  to  describe  details  of  the  hydrodynamic  field  at  the 
scales  required  for  the  particular  project.  Figure  12  shows  a  CMS-M2D  grid 
overlaid  on  a  portion  of  an  ADCIRC  mesh  developed  for  Shinnecock  Inlet,  NY. 
Distances  between  ADCIRC  nodes  are  a  few  times  larger  than  the  CMS-M2D 
cell  sizes,  but  are  not  greatly  larger.  If  the  ADCIRC  nodes  were  spaced  further 
apart,  having  only  a  few  nodes  in  the  vicinity  of  the  CMS-M2D  boundary,  details 
of  the  flow  field  would  not  be  adequately  described  to  capture  the  inlet  and  ocean 
hydrodynamics  of  the  area. 
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Figure  12.  CMS-M2D  grid  and  ADCIRC  mesh  for  Shinnecock  Inlet,  NY 


Temporal  resolution  of  the  boundary  information  provided  to  CMS-M2D 
from  the  larger-domain  model  must  also  be  considered.  Output  frequency  of 
larger-domain  model  solutions  should  be  set  to  minimize  error  in  forcing  for  the 
scales  of  motion  calculated.  As  an  example,  water-level  curves  calculated  by  the 

function  T|  =  sin  (271^ / 12.42) ,  where  t  is  in  hours,  and  output  at  increments  of 

1.0  and  0.25  hr  are  shown  in  Figure  13.  Output  at  0.25  hr  produces  a  curve  that 
describes  the  water  level  significantly  better  than  the  curve  output  at  1 .0  hr.  An 
example  of  the  error  introduced  by  the  1-hr  interval  output  is  shown  at  the  second 
peak,  in  which  a  3 -cm  difference  is  encountered. 

Application  of  a  solution  from  a  regional  model  as  boundary  conditions  for 
CMS-M2D  can  be  conducted  for  simulations  in  which  any  combination  of  tide, 
wind,  and  waves  are  needed.  When  the  regional  model  is  launched,  it  should 
contain  all  forcing  to  be  included  in  the  simulation  (tide,  wind,  etc.)  except  for 
waves.  Wave  forcing  should  be  applied  only  to  the  local  CMS-M2D  simulation. 
There  are  two  reasons  for  this  approach.  First,  if  waves  are  applied  as  forcing, 
CMS-M2D  automatically  adjusts  its  forcing  boundaries  for  the  presence  of  waves 
(wave-adjusted  boundary  condition)  to  compute  set  up  and  set  down,  and  to 
allow  wave-driven  flow  into  and  out  of  the  domain.  If  the  regional  model 
includes  wave  forcing,  then  the  regional  solution  will  transmit  the  wave-driven 
component  of  the  solution  into  the  CMS-M2D  boundary  conditions. 

Combination  of  the  prescribed  boundary  conditions  from  the  regional  model  and 
the  wave-adjusted  boundary  condition  will  then  result  in  the  wave  forcing  being 
applied  twice  at  the  CMS-M2D  boundary.  Secondly,  the  regional  model  will 
usually  have  coarser  resolution  than  the  CMS-M2D  local  grid,  and  will  not  have 
adequate  resolution  in  the  surf  zone  to  accurately  describe  the  distribution  of  set 
up,  set  down,  and  wave-driven  currents.  If  waves  are  included  in  the  regional 
model  forcing,  the  interpolation  or  extrapolation  of  the  wave-driven  component 
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of  the  regional  solution  to  the  local  CMS-M2D  boundary  will  not  contain 
sufficient  detail  to  accurately  describe  the  response  in  and  near  the  surf  zone. 
Thus,  error  will  be  introduced  into  the  CMS-M2D  boundary  conditions. 


Time,  hr 


Figure  13.  Time  discretization  of  a  sinusoidal  water-level  curve 


Coupling  with  STWAVE  and  WABED 

CMS-M2D  and  a  wave  model  such  as  STWAVE  (Militello  and  Zundel  2003) 
or  WABED  (Lin  et  al.  2006)  can  be  coupled  through  the  SMS  Steering  Module 
(Chapter  8).  Coupling  can  be  conducted  by  supplying  CMS-M2D  with  radiation- 
stress  gradients  and  wave  properties  calculated  by  the  wave  model  and  by 
applying  currents  and  water  depth  ( h  +  r\)  calculated  by  CMS-M2D  as  input  to 
the  wave  model.  The  user  has  the  option  of  selecting  one  or  more  of  these 
linkages.  Guidance  is  provided  here  to  assist  the  user  in  setting  up  a  correct  and 
successful  coupled  simulation. 

CMS-M2D  and  STWAVE  (or  WABED)  calculate  on  different  coordinate 
systems  that  may  or  may  not  be  aligned,  depending  on  the  orientation  of  the 
shoreline  relative  to  geographic  coordinates.  The  coordinate  system  for  CMS- 
M2D  can  be  specified  in  the  range  of  ±  45  deg  from  geographic  coordinates, 
meaning,  that  positive  x  is  directed  within  45  deg  of  east  and  positive  y  is 
directed  within  45  deg  of  north.  An  angle  provided  in  the  CMS-M2D  control  file 
defines  the  deviation  of  the  CMS-M2D  grid  from  geographic  coordinates. 
STWAVE  operates  on  a  grid  aligned  such  that  the  x-axis  is  directed  onshore  and 
the  y-axis  is  directed  alongshore.  Figure  14  shows  three  examples  of  CMS-M2D 


Chapter  7  Model  Features 


81 


and  STWAVE  coordinates  for  different  shoreline  orientations.  Each  model  must 
be  independently  established  so  that  its  coordinate  system  is  consistent  with  its 
computational  approach.  For  coupling,  the  CMS-M2D  and  STWAVE  grids 
overlap  and  information  is  mapped  from  one  model  to  the  other.  The  SMS 
automatically  calculates  any  required  rotations  of  components  when  mapping 
fields  between  STWAVE  and  CMS-M2D. 

In  areas  of  the  computational  domain  where  wave  breaking  or  strong  wave- 
current  interaction  takes  place,  resolution  for  CMS-M2D  and  STWAVE  should 
be  similar.  By  specifying  cells  in  both  models  to  have  similar  spacing,  coupling 
efficiency  is  maximized  because  high-resolution  details  calculated  by  one  model 
are  not  lost  when  the  solution  field  is  mapped  to  the  other  model.  Figure  15 
shows  STWAVE  and  CMS-M2D  grid  spacing  in  the  nearshore  area.  Surf  zone 
width  is  indicated  by  the  line  denoting  10  STWAVE  cells.  In  this  area,  CMS- 
M2D  and  STWAVE  have  similar  spacing  in  the  cross-shore.  Cell  sizes  in  the 
CMS-M2D  grid  become  larger  seaward  of  the  surf  zone. 

Coupling  CMS-M2D  and  STWAVE  (or  WABED)  requires  that  the  user 
specify  the  steering  interval,  or  elapsed  time  between  calls  to  STWAVE. 

Selection  of  the  steering  interval  is  dependent  on  the  processes  that  are  most 
significant  to  the  goals  of  the  modeling  effort.  A  smaller  steering  interval 
tightens  coupling  between  the  models,  increasing  accuracy.  However,  smaller 
steering  intervals  require  more  wave  model  runs  and  increase  the  overall 
computation  time.  Thus,  the  user  must  balance  the  cost  of  run  time  versus 
accuracy. 

Temporal  scales  of  processes  being  modeled  also  play  a  role  in  the  selection 
of  the  steering  interval.  For  example,  if  a  mean  wave  condition  is  being  applied 
in  a  predominantly  tidal  situation,  and  the  wave  properties  do  not  change  much 
over  time,  the  steering  interval  can  be  set  to  a  relatively  large  value.  If  a  storm  is 
being  modeled  and  full  coupling  between  the  wave  model  and  CMS-M2D  is 
required,  then  the  steering  interval  should  be  set  to  a  smaller  value.  If  a  situation 
is  studied  in  which  there  is  strong  wave-current  interaction,  such  as  at  an  inlet, 
then  a  shorter  steering  interval  may  be  specified  to  capture  the  modification  of 
the  waves  by  the  tidal  current  and  the  time-varying  water  level.  Typical  steering 
intervals  are  3  hr  for  fair  weather  conditions;  and  for  storm  waves,  the  steering 
interval  should  be  more  frequent.  Judgment  and  experience  must  be  exercised,  as 
for  all  numerical  models,  and  sensitivity  analysis  is  recommended  for  a  particular 
application  to  determine  the  most  appropriate  steering  interval. 
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Figure  14.  Example  CMS-M2D  and  STWAVE  grid  orientations 
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Figure  15.  Example  CMS-M2D  and  STWAVE  grid  spacing 


Output  Options 

CMS-M2D  provides  two  types  of  output  that  can  be  selected  by  the  user. 
Time  series  of  calculated  variables  at  specific  cells,  called  observation  cells,  can 
be  saved  at  user- specified  time  intervals.  Global  fields  can  be  written  at  user- 
specified  times. 

All  variables  are  output  at  their  computational  location  in  the  cell.  Thus, 
water-surface  elevation  and  depth  are  at  the  cell  center,  the  w-component  of 
velocity,  x-component  of  flow  rate,  and  x-component  of  transport  rate  are  at  the 
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left  cell  face  center,  and  the  v-component  of  velocity,  y-component  of  flow  rate, 
andy-component  of  transport  rate  are  at  the  bottom  cell  face  center. 

Observation  cell  time  series 

Time  series  of  water-surface  elevation,  ^-component  of  velocity,  v- 
component  of  velocity,  x-component  of  flow  rate,  and  y-component  of  flow  rate 
can  be  saved  at  observation  cells.  The  user  can  specify  any  number  of  cells  as 
observation  cells.  Any  combination  of  variable  output  may  be  selected  ranging 
from  one  to  all  five  previously  listed.  A  time  interval  for  output  must  be 
specified,  and  the  most  accurate  timing  of  output  is  achieved  if  the  output  interval 
is  specified  as  an  integer  multiple  of  the  calculation  time  step.  Observation  cell 
output  will  take  place  from  the  start  to  the  end  of  the  simulation.  The  SMS 
interface  provides  tools  for  specifying  all  aspects  of  the  observation  cell  output. 
Time  series  of  each  variable  selected  for  output  is  written  to  a  separate  file  and 
values  for  all  observation  cells  are  included  in  that  file.  Chapter  9  describes  the 
format  and  provides  an  example  of  the  time  series  observation  cell  output  files. 

Global  field  output 

Global  output  of  scalar  (water-surface  elevation  and  depth)  and  vector 
components  (velocity  and  sediment  transport  rates)  can  be  written  at  user- 
specified  times.  Each  variable  type  is  written  to  a  separate  file.  CMS-M2D  reads 
two  files  containing  times  at  which  global  output  is  specified,  one  file  for  scalar 
variables  and  one  file  for  vector  variables.  Thus,  global  output  times  for  the  two 
variable  types  are  not  required  to  be  concurrent,  and  the  increment  between 
successive  times  does  not  have  to  be  constant.  By  specifying  discreet  time 
stamps,  the  user  has  flexibility  for  creating  global  files  with  more  dense  temporal 
resolution  during  certain  time  intervals.  The  SMS  interface  provides  tools  for 
specifying  all  aspects  of  the  global  output.  Chapter  9  describes  the  format  and 
provides  an  example  of  the  global  output  files. 
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8  Surfacewater  Modeling 
System  Interface  for 
CMS-M2D 


CMS-M2D  is  supported  by  an  interface  with  SMS  Versions  8.0  and  higher. 
The  interface  contains  tools  for  grid  development,  parameter  specification, 
control  file  setup,  boundary  specification  including  extraction  of  water-surface 
elevation  and/or  velocities  from  regional  models  such  as  ADCIRC,  model  runs, 
post-processing  of  global  field  values,  visualization,  and  coupling  of  CMS-M2D 
with  STWAVE  or  WABED  through  the  Steering  Module.  This  chapter  provides 
instruction  on  creating  and  working  with  CMS-M2D  projects  within  the  SMS. 
Dialogs  shown  are  from  SMS  9.0  and  9.2. 

Access  to  the  CMS-M2D  interface  is  obtained  through  the  Cartesian  Grid 
Module  in  the  SMS.  The  Map  Module  can  also  be  used  to  create  simulations  for 
CMS-M2D  via  a  CMS-M2D  Coverage.  The  interface  for  CMS-M2D  includes: 

a .  CMS-M2D  Coverage  and  Map  tools. 

b.  Cartesian  Grid  Data  Module  (tools  and  display  options). 

c.  CMS-M2D  Menu. 

d.  Steering  Module. 

Required  Information 

A  CMS-M2D  grid  is  a  Cartesian  Grid  with  cells  that  may  be  of  varying  sizes. 
Each  cell  has  a  location,  side  dimensions  (Ax  and  Ay ),  and  depth.  Grid 
definition  within  SMS  includes: 

a.  A  geographic  location  -  the  position  of  the  first  cell  and  the  orientation 
of  the  grid. 

b.  Dimensions  -  domain  extent  and  number  of  cells  in  each  direction. 

c.  Cell  sizes  -  the  width  of  each  column  and  height  of  each  row  in  the  grid. 

d.  Depths  -  the  water  depth  at  the  center  of  each  cell. 

The  SMS  interface  provides  tools  and  methodology  for  the  user  to  define 
each  of  these  components  and  to  develop  the  grid.  Depths  over  the  model 
domain  are  the  most  complex  component  of  the  grid  because  these  values  can 
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represent  any  geometric  shape.  Bathymetric  information  is  supplied  to  the  SMS 
by  the  user  as  either  a  constant  depth  or  as  a  spatially  distributed  set  of  data 
points  (also  known  as  a  triangulated  irregular  network  or  TIN).  Each  point  in  the 
TIN  has  a  depth  associated  with  it.  The  SMS  can  read  Digital  Elevation  Model 
(DEM)  grids  or  scattered  data  point  surveys  and  display  them  as  a  surface  to 
show  the  area  over  which  a  grid  will  be  generated.  A  typical  scatter  data  set  is 
illustrated  by  the  red  crosses  in  Figure  16.  The  SMS  interpolates  scattered  data 
to  the  grid  to  define  the  depths  at  each  cell.  For  more  information  on  scatter  data 
sets  and  the  Scatter  Data  Module,  refer  to  the  SMS  Help  file  or  SHOALS  toolbox 
documentation  (Wozencraft  et  al.  2002). 

After  defining  a  surface  to  represent  the  depth  values,  the  user  specifies  the 
position,  orientation,  and  extent  of  the  grid  using  a  rectangular  object  called  a 
grid  frame.  Simple  grids  with  constant- sized  cells  can  be  created  in  the  Cartesian 
Grid  Module.  More  complex  grids  are  created  in  the  Map  Module. 


Figure  16.  Grid  frame  around  scattered  data  points 

Grid  Generation  from  CMS-M2D  Coverage 

Most  grids  will  be  developed  within  the  Map  Module.  Information  in  the 
Map  Module  is  stored  in  layers  or  coverages.  Each  coverage  has  a  specific  type, 
which  defines  the  properties  of  the  information  stored  in  that  layer.  The  SMS 
includes  a  CMS-M2D  coverage  type  to  allow  the  definition  of  a  CMS-M2D 
simulation.  A  default  coverage  is  in  the  SMS  at  all  times.  This  default  coverage 
can  be  used  to  create  a  CMS-M2D  coverage  by  changing  its  type.  Otherwise,  a 
new  coverage  with  type  CMS-M2D  can  be  created  by  left-clicking  on  Map  Data 
in  the  Project  Explorer  (the  data  tree  on  the  left  side  of  screen)  and  then  selecting 
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New  Coverage.  To  convert  a  coverage  to  a  CMS-M2D  coverage,  left-click  on 
the  coverage  to  select  it,  then  right-click  and  choose  Type  to  expand  the  Coverage 
Type  options,  then  select  CMS-M2D.  By  changing  a  coverage  to  be  a  CMS- 
M2D  coverage,  the  modeler  has  instructed  the  SMS  to  create  a  CMS-M2D  grid 
from  the  information  being  entered. 

Grid  frame  creation  and  editing 

With  a  CMS-M2D  coverage  active,  the  grid  frame  is  defined  by  selecting  the 


Create  Grid  Frame  tool  4-14  .  When  this  tool  is  active,  clicking  in  the  main 
display  window  of  SMS  defines  the  position  and  extents  of  a  grid  frame.  The 
first  click  defines  the  origin  of  the  grid,  the  second  click  defines  the  bottom  edge 
of  the  grid  and  its  size  in  the  “I”  direction,  and  a  third  click  defines  the  size  of  the 
grid  frame  in  the  “J”  direction.  A  new  grid  frame  or  enclosing  shape  for  the  grid 
is  created  on  the  screen  (Figure  16).  This  grid  frame  can  be  moved,  rotated, 
enlarged,  or  reduced  in  size  either  graphically  or  by  accessing  edit  windows 
before  the  grid  is  generated  to  fill  the  frame. 

To  edit  a  grid  frame,  the  modeler  selects  the  Select  Grid  Frame  tool  [a 

and 

clicks  on  the  grid  frame  to  be  edited.  Handles  appear  at  the  corners  and  sides  of 
the  selected  grid.  The  user  may  drag  any  of  these  handles  to  change  the  size  and 
position  of  the  grid  frame.  A  circular  handle  that  extends  from  the  “I”  axis  of  the 
grid  frame  can  be  dragged  to  change  the  orientation  of  the  grid  frame.  The 
following  graphical  editing  operations  and  their  functions  are  available  when  a 
grid  frame  is  selected: 

a.  Move  Frame  -  Click  the  box  located  at  the  center  of  the  frame  interior 
and  drag  to  relocate  the  frame. 

b.  Resize  Frame  -  Click  a  highlighted  comer  or  edge  and  drag  to  resize. 

c.  Rotate  Frame  -  Click  inside  the  circle  near  the  bottom  right  comer  of  the 
frame  and  drag  to  rotate  the  frame. 

Grid  frame  parameters  can  also  be  explicitly  modified  using  the  edit  window  that 
appears  when  the  grid  frame  is  selected.  These  parameters  are: 

a.  Grid  Origin  -  The  Origin  X  and  Origin  Y  edit  fields  allow  the  user  to 
explicitly  specify  the  bottom  left  comer  location  of  the  grid  frame. 

b.  Angle  of  rotation  -  The  angle  edit  field  can  be  used  to  set  the  angle  that 
the  grid  frame  will  be  rotated  counterclockwise  from  the  +x-axis.  This 
angle  should  be  between  -45  and  45  deg. 

The  grid  frame  size  is  displayed  at  the  lower  edge  of  the  screen  as  it  is  being 
edited. 

Grid  generation 

After  the  grid  frame  is  defined,  a  CMS-M2D  grid  is  generated  in  SMS  with 
the  Feature  Objects  |  Map  ->  2D  Grid  command.  This  command  opens  the 
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Map->2D  Grid  dialog  (Figure  17).  For  a  simple  grid  frame,  this  dialog  allows 
the  user  to  specify  the  number  of  cells  in  each  direction  (or  the  cell  size  in  each 
direction)  and  the  source  for  depth  information.  The  resulting  grid  will  consist  of 
constant-sized  cells. 


Figure  17.  Map->  2D  Grid  and  Refine  Point  dialogs 


CMS-M2D  allows  varying  cell  sizes  to  provide  greater  resolution  in  areas 
where  needed.  The  interface  provides  for  the  development  of  grids  with  greater 
resolution  in  specific  areas  through  the  creation  of  refine  points.  A  refine  point  is 

produced  by  creating  a  feature  point  *  .  at  the  location  where  specific  resolution 
is  to  be  assigned.  Double  clicking  on  the  feature  point  (with  the  Select  Feature 


Point  tool  ^  active)  invokes  the  Refine  Point  attributes  dialog.  This  dialog 
allows  for  specification  of  cell  sizes  around  the  point,  spatial  change  in  cell  sizes 
with  distance  from  the  refine  point,  and  a  maximum  cell  size.  For  the  settings 
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shown  in  the  Refine  Point  portion  of  Figure  17,  the  cell  around  the  refine  point 
would  be  a  10-m  x  10-m  cell,  the  cells  would  get  10  percent  bigger  with  each 
row  or  column,  and  the  largest  cell  would  be  20  m  x  20  m.  If  refine  points  are 
specified,  the  Cell  Options  portion  of  the  Map->2D  Grid  dialog  does  not  contain 
user-specified  options,  but  informs  the  user  that  the  cell  properties  will  be 
calculated  from  the  refine  point  specifications. 

When  refine  points  are  present  in  the  CMS-M2D  coverage,  the  top  portion  of 
the  Map->2D  Grid  dialog  is  dimmed  out.  The  SMS  will  generate  cells  that 
match  the  refine  point  specifications.  If  multiple  refine  points  are  present  and 
conflict  with  each  other,  cells  will  be  created  to  meet  the  criteria  of  all  refine 
points  as  closely  as  possible.  Figure  18  shows  a  grid  developed  with  a  refine 
point  in  the  inlet  and  cell  strings  around  the  grid  boundary. 


Figure  18.  SMS-generated  CMS-M2D  grid 


Each  cell  will  be  assigned  a  depth  based  on  the  depth  option,  and  cells  will 
be  assigned  to  be  land  or  water  based  on  the  resulting  depths.  However,  the 
modeler  may  force  islands,  or  other  coastline  features,  into  a  grid  by  creating  arcs 

with  the  Create  Feature  Arc  tool  d  .  These  arcs  will  then  represent  the 
coastline  in  the  CMS-M2D  coverage.  Attributes  of  the  arc  can  be  specified  by 

activating  the  Select  Feature  Arc  tool  .  and  then  selecting  the  arc.  With  an  arc 
selected,  the  user  can  issue  the  Feature  Objects | Attributes  command  in  the 
pull-down  menu.  This  action  brings  up  the  dialog  shown  in  Figure  19.  Cells 
generated  along  this  arc  will  be  treated  as  specified  by  the  arc  type.  By  default, 
cells  intersected  by  these  coastline  arcs  are  classified  based  on  the  percent  of  the 
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cell  on  the  “land”  side  (percent  preference  arc).  If  more  than  half  the  cell  is  land, 
the  cell  is  classified  as  land.  In  some  situations,  however,  the  model  may  require 
a  continuous  stretch  of  either  land  or  water  to  represent  a  specific  shoreline 
feature,  such  as  a  jetty  or  narrow  canal.  In  these  situations,  the  coastline  arcs 
may  also  be  flagged  as  “land”  or  “water”  preference.  Thus,  the  three  options  for 
arc  preferences  are: 

a.  Percent  preference:  If  more  than  50  percent  of  the  cell  through  which  the 
arc  cuts  is  land,  then  the  cell  will  be  land.  If  more  than  50  percent  of  the 
cell  is  water,  then  the  cell  will  be  water. 

b.  Land  preference:  Forces  cells  lying  on  the  arc  to  be  land. 

c.  Water  preference:  Forces  cells  on  the  arc  to  be  water. 


Figure  19.  Arc  options  for  developing  coastlines 


After  an  arc  type  is  specified,  selecting  the  arc  will  reveal  the  water  and  land 
sides  of  the  arc,  which  are  displayed  as  blue  and  brown  arrows,  respectively.  If 
the  water  and  land  sides  of  the  arc  are  opposite  from  what  they  should  be,  the  arc 
direction  can  be  reversed  by  clicking  Reverse  Arc  Direction  under  the  Feature 
Objects  pull-down  menu. 

The  Map->2D  Grid  command  also  creates  cell  strings  across  all  ocean 
boundaries  of  the  grid.  These  strings  are  described  in  the  following  section  and 
are  tools  for  assigning  boundary  conditions  for  the  numerical  model  run. 

Cartesian  Grid  Module 

The  Cartesian  Grid  Module  contains  tools  for  editing  2D  Cartesian  grids. 
These  grids  consist  of  cells  aligned  with  a  rectilinear  coordinate  system.  An 
existing  grid  can  be  read  in  from  a  CMS-M2D  simulation  file,  or  created  through 
the  Map  Module.  To  enter  the  Cartesian  Grid  Module  from  another  module, 
select  Cartesian  Grid  Data  from  the  Data  Tree.  With  a  grid  in  memory,  the 
following  tools  are  available  to  edit  the  grid: 
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BB  Select  Cell 

The  Select  Cell  tool  is  used  to  select  a  grid  cell.  A  single  cell  is  selected  by 
clicking  on  it.  A  second  cell  can  be  added  to  the  selection  list  by  holding  the 
SHIFT  key  while  selecting  it.  Multiple  cells  can  be  selected  at  once  by  dragging 
a  box  around  them.  A  selected  cell  can  be  de-selected  by  holding  the  SHIFT  key 
as  it  is  clicked. 

When  a  single  cell  is  selected,  its  Z  coordinate  is  shown  in  the  Edit  Window. 
The  Z  coordinate  can  be  changed  by  typing  a  new  value  in  the  edit  field,  which 
updates  the  depth  function.  If  multiple  cells  are  selected,  the  Z  coordinate  field  in 
the  Edit  Window  shows  the  average  depth  of  all  selected  cells.  If  this  value  is 
changed,  the  new  value  will  be  assigned  to  all  selected  cells. 

With  one  cell  selected,  the  Edit  Window  shows  the  cells  ij  location.  With 
multiple  cells  selected,  the  Edit  Window  shows  the  number  of  selected  cells. 


Select  Row/  BB  Select  Column 

The  Select  Row  and  Select  Column  tools  are  used  to  select  cell  rows  and 
columns,  respectively.  Multiple  rows  and  columns  are  selected  in  the  same 
manner  as  selecting  multiple  individual  cells:  holding  the  SHIFT  key,  etc. 


When  the  Insert  Column  or  Insert  Row  tools  are  active,  clicking  within  a 
cell  splits  the  row/column  containing  the  selected  cell,  creating  a  new  row  or 
column  in  the  grid.  The  Z- values  of  all  split  cells  are  the  same  as  the  original 
cells’  values. 

*  *  Drag  Column/  +  Drag  Row  Boundary 

The  position  of  the  edge  of  rows  or  columns  in  a  grid  can  be  changed  with 
the  Drag  Column  or  Drag  Row  tools.  These  tools  make  one  column/row 
narrower  while  making  its  neighbor  wider. 

These  tools  allow  for  manual  specification  of  the  resolution  in  specific 
portions  of  the  grid.  Note  that  depth  values  are  not  adjusted,  so  significant 
dragging  of  boundaries  should  be  avoided,  or  depths  should  be  re-interpolated 
after  the  boundaries  are  modified. 


M  Create  Cell  String 

The  Create  Cell  String  tool  allows  the  modeler  to  group  a  string  of  cells 
together  for  the  purpose  of  assigning  boundary  conditions.  Cell  strings  are 
created  automatically  around  water  boundaries  when  a  grid  is  generated.  The 
user  may  create  others  as  desired  or  delete  and  replace  the  automatically 
generated  cell  strings.  When  the  Create  Cell  String  tool  is  active,  the  modeler 
selects  each  cell  to  be  added  to  the  string.  By  holding  down  the  SHIFT  key,  all 
boundary  cells  between  the  previously  selected  cell  and  the  selected  cell  are 
added  to  the  cell  string. 
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Select  Cell  String 


To  specify  a  boundary  condition,  the  modeler  must  create  a  cell  string  along 
the  desired  boundary  cells,  and  then  select  the  cell  string  while  the  Select  Cell 
String  tool  is  active.  Specification  of  a  boundary  condition  for  the  selected  cell 
string  is  conducted  through  the  Assign  BC  dialog,  which  is  accessed  through  the 
CMS-M2D  pull-down  menu. 


CMS-M2D  Menu 

The  CMS-M2D  menu  includes  commands  for  managing  the  simulation. 
Management  operations  are  editing  boundary  conditions  and  cell  attributes, 
checking  the  simulation  for  common  errors,  and  running  a  model.  Commands 
from  the  menu  are  explained  in  the  following  sections: 

Assign  BC 

The  Assign  BC  command  allows  the  user  to  assign  a  boundary  condition  to 
the  cell  string  through  the  CMS-M2D  Boundary  Conditions  dialog  (Figure  20). 
This  command  is  active  only  if  a  cell  string  is  selected. 


Figure  20.  CMS-M2D  Boundary  Conditions  dialog 
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Boundary  conditions  specified  within  this  dialog  include  the  following: 

a.  Flow  Rate-forcing:  This  type  of  boundary  condition  allows  the  modeler 
to  define  a  time  series  of  flow  rates  to  be  prescribed  at  the  boundary. 

The  time  series  associated  with  this  boundary  contains  a  list  of  times  and 
flow  rates  in  m3/s  to  be  applied  at  boundary  cells.  Each  cell  contained  in 
the  cell  string  will  have  the  prescribed  flow  rate.  Time  series  can  be 
developed  within  the  SMS  by  entering  the  Define  Curve  dialog. 
Alternately,  a  pre-existing  file  can  be  assigned  by  clicking  on  the  Browse 
file  tab.  If  the  Interpolate  between  times  box  is  checked,  CMS-M2D 
linearly  interpolates  between  flow  rate  values  at  every  time  step.  If  the 
Interpolate  between  times  box  is  not  checked,  boundary  flow  rate  values 
are  updated  only  at  the  times  that  they  are  provided  in  the  input  file.  It  is 
strongly  recommended  that  the  Interpolate  between  times  box  be 
checked  for  all  simulations. 

b.  Water-Surface  Elevation  (WSE)  forcing:  This  type  of  boundary 
condition  allows  the  modeler  to  define  a  time  series  of  water  level.  The 
time  series  associated  with  this  boundary  contains  a  list  of  times  and 
water  levels  (in  meters)  to  be  prescribed  along  the  boundary.  The 
Interpolate  between  times  checkbox  instructs  CMS-M2D  on  how  the 
time  series  water-level  information  is  to  be  treated  within  CMS-M2D 
when  forcing  a  boundary.  If  the  Interpolate  between  time s  box  is 
checked,  CMS-M2D  linearly  interpolates  between  water-level  values  at 
every  time  step.  If  the  Interpolate  between  times  box  is  not  checked, 
water-level  values  applied  as  boundary  conditions  are  updated  only  at  the 
times  that  they  are  provided  in  the  input  file.  It  is  strongly  recommended 
that  the  Interpolate  between  times  box  be  checked  for  all  simulations. 

Two  options  for  assigning  a  water-surface  elevation  boundary  condition  are 

available  as  follows: 

(1)  Single  time  series  across  a  boundary:  Time  series  of  water-surface 
elevation  can  be  developed  with  SMS  by  clicking  on  the  Define  Curve 
button.  Alternately,  a  pre-existing  file  can  be  assigned  by  clicking  on 
the  Browse  file  tab. 

(2)  Multiple  time  series  across  a  boundary:  Time  series  of  water-surface 
elevation  in  which  each  cell  in  the  cell  string  is  assigned  a  unique  value 
of  water  level  can  be  developed  in  the  SMS  by  selecting  Extract  from 
data  set .  If  a  regional  model  such  as  ADCIRC  and  its  global  water- 
surface  elevation  solution  are  loaded,  the  extract  From  Regional  Model 
capability  is  made  available  as  a  possible  source  of  the  boundary 
condition.  The  Using  Tidal  Constituents  option  is  also  available  which 
creates  time  series  of  water-surface  elevations  from  a  selection  of  tidal- 
constituent  databases.  If  the  boundary  condition  is  to  be  extracted 
through  the  From  Regional  Model  option,  the  SMS  prompts  the  user  to 
specify  the  source  of  the  extracted  information  (a  functional  data  set 
from  the  regional  model)  using  the  Extracted  Boundary  Condition 
dialog  (Figure  21).  Extraction  of  water-surface  elevations  is  available 
for  specification  of  boundary  conditions  from  any  regional  2D  model 
that  can  be  brought  into  SMS. 
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If  the  boundary  condition  is  to  be  developed  with  the  Using 
Tidal  Constituents  option,  the  SMS  opens  a  dialog  for 
specification  of  timing  control  for  the  extraction  and  a  Tidal 
Constituents  button  which  opens  a  second  dialog  in  which 
specific  tidal  constituents  can  be  selected  from  either  the 
LeProvost  (Le  Provost  et  al.  1994)  or  the  CMS-ADCIRC  (Mukai 
et  al.  2002)  database.  The  starting  time  and  date  of  the 
simulation  must  be  entered  so  that  the  time  components  of  the 
tidal  constituents  will  correspond  to  the  simulation.  After  all 
settings  for  the  tidal  constituents  are  selected,  clicking  OK  will 
start  the  process  of  extracting  the  tidal  constituents  from  the 
selected  database  and  developing  the  time  series  boundary 
condition  file  for  CMS-M2D.  This  option  requires  the  grid  to  be 
defined  relative  to  a  global  coordinate  system. 

c.  Tidal-Constituent  forcing:  These  boundary  conditions  apply  up  to  eight 
tidal  constituents  to  force  water-surface  elevations  along  the  selected  cell 
string.  Tidal  constituents  are  specified  within  the  Tidal  Constituent 
dialog  accessed  in  the  Model  Control  dialog.  This  option  for  tidal- 
constituent  forcing  provides  CMS-M2D  with  amplitude  and  phase  values 
that  are  spatially  constant  along  a  cell  string.  CMS-M2D  then  computes 
the  temporal  variation  in  the  specified  constituents  internally. 

d.  Extract  WSE  and  Velocity  (Vel)  forcing:  For  this  boundary  condition 
type,  the  SMS  detects  if  a  regional  model,  such  as  ADCIRC,  and  its 
global  water-surface  elevation  and  velocity  solution  files  have  been 
loaded,  and  activates  the  extract  capability  as  a  possible  source  of  the 
boundary  condition  input.  If  the  boundary  condition  is  assigned  to  be  an 
extracted  boundary  condition,  the  SMS  prompts  the  user  to  specify  the 
source  of  the  extracted  information  (a  functional  data  set  from  the 
regional  model)  using  the  Extract  Boundary  Condition  dialog.  Both 
water-surface  elevation  and  velocity  from  the  regional  model  must  be 
present  to  extract  values  for  this  boundary  type.  The  velocity  solution 
that  is  to  be  applied  in  the  extraction  is  selected  within  the  Regional 
Vector  Model  Solution  field  near  the  bottom  of  the  dialog.  Extraction  of 
water-surface  elevations  and  velocities  is  available  for  specification  of 
boundary  conditions  from  any  larger-domain  2D  model  that  can  be 
brought  into  the  SMS. 

File  formats  for  use  with  CMS-M2D  are  described  in  Chapter  9  and 
Appendix  A. 
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Figure  21 .  Extract  Boundary  Conditions  dialog 


Figure  22.  Extract  Tidal  Constituents  dialogs 
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Delete  BC 

The  Delete  BC  command  allows  the  user  to  delete  the  boundary  condition 
assigned  to  a  cell  string.  A  cell  string  must  be  selected  to  activate  this  command. 

Assign  Cell  Attributes 

The  Assign  Cell  Attributes  command  (Figure  23)  allows  the  modeler  to  set 
the  status  for  one  or  more  selected  cells.  A  cell  can  be  an  Inactive  Land  Cell,  an 
Active  Ocean  Cell,  an  Inactive  Ocean  Cell,  or  an  Observation  Cell.  These  cell 
types  are  defined  as: 

Inactive  Land  Cell:  A  cell  that  is  considered  as  land  within  the  SMS  and  will 
not  be  saved  to  the  CMS-M2D  computational  domain.  If  an  Inactive  Land  Cell 
is  adjacent  to  an  Active  Ocean  Cell,  the  interface  between  the  two  cells  will  be 
treated  as  a  wall. 

Active  Ocean  Cell:  A  cell  that  is  considered  as  water  within  the  SMS  and 
will  be  saved  to  the  CMS-M2D  computational  domain.  All  cells  in  which 
computations  are  to  take  place  must  be  designated  as  Active  Ocean  Cells. 

Inactive  Ocean  Cells:  A  cell  that  is  considered  as  water  within  the  SMS  but 
will  not  be  saved  to  the  CMS-M2D  computational  domain.  These  cells  are 
specified  adjacent  to  cell  strings  outside  of  the  Active  Ocean  Cell  region  to 
denote  that  the  area  is  water.  This  information  is  used  by  the  SMS  to  apply 
correct  boundary  specifications  in  the  CMS-M2D  grid. 

Observation  Cells:  An  Observation  Cell  is  a  numerical  station  and  must  be 
assigned  as  an  Active  Ocean  Cell.  If  a  cell  is  specified  as  an  Observation  Cell, 
the  Observation  Cell  Output  Type  portion  of  the  Assign  Cell  Attributes  dialog 
becomes  active  and  the  user  can  specify  whether  Time  Series  (water-surface 
elevation  and  velocity)  or  Flow  Rate  values  are  to  be  output  as  time  series. 
Further  output  specifications  for  Observation  Cells  are  specified  in  the  Model 
Control  dialog  discussed  later  in  this  chapter. 

The  Assign  Cell  Attributes  dialog  also  provides  the  capability  to  assign  cells 
as  hard  bottom  within  the  Hard  Bottom  Options  area.  To  specify  a  cell  as  a  hard- 
bottom  cell,  the  option  “Mark  selected  cells  as  non-erodible”  must  be  checked. 
Then,  the  hard-bottom  depth  (maximum  erosion  depth)  is  assigned  as  either  the 
cell  depth  or  is  specified  as  a  value  that  is  different  from  and  greater  than  the  cell 
depth.  The  option  to  specify  the  hard-bottom  depth  as  a  depth  other  than  the  cell 
depth  allows  for  cells  to  start  the  simulation  covered  with  sediment. 

Bottom  roughness  can  also  be  assigned  in  the  Assign  Cell  Attributes  dialog 
as  Manning’s  n. 
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Figure  23.  Assign  Cell  Attributes  dialog 


Merge  Cells 

The  Merge  Cells  command  allows  the  modeler  to  merge  consecutive  rows  or 
columns  into  one.  The  command  is  enabled  only  if  rows  or  columns  have  been 
selected  with  the  appropriate  tool  (select  row  or  column). 

Model  Check 

The  Model  Check  command  performs  a  number  of  checks  on  the  simulation 
to  ensure  a  valid  model.  If  the  system  detects  any  missing  or  problematic 
components,  it  displays  a  message  in  the  Model  Checker  dialog  (Figure  24).  The 
top  portion  of  the  dialog  displays  the  problem  while  the  middle  and  bottom 
sections  describe  the  problem  and  a  series  of  steps  to  correct  the  problem.  When 
performing  a  model  check,  the  SMS  ensures  that: 

a.  All  water  boundaries  have  boundary  conditions  specified. 

b.  All  observation  cells  have  time  outputs  specified. 

c.  The  specified  time  step  is  less  than  the  maximum  value  computed  from 
the  cell  sizes  and  depths. 

d.  All  cell  aspect  ratios  are  less  than  2. 

e.  Correct  model  control  specifications  (i.e.,  if  a  tidal  boundary  exists,  make 
sure  that  tidal  constituents  have  been  defined  for  forcing). 
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f  No  overlapping  cell  strings  exist. 


Figure  24.  Model  Checker  dialog 


CMS-M2D  Model  Control 

The  CMS-M2D  Model  Control  command  displays  the  Model  Control 
dialog  (Figure  25).  Five  tabs  allow  access  to  different  model  input  and 
specification  dialogs.  These  dialogs  are: 

Model  Control'.  Set  up  optional  input  files,  specify  sediment  transport 
options,  and  specify  wave  input. 

Model  Parameters'.  Specify  miscellaneous  parameters  for  wind  and  latitude, 
specify  whether  advection  and  mixing  terms  are  invoked  in  momentum  equation, 
specify  whether  to  include  wall  friction,  and  set  depth  at  which  cells  are  treated 
as  dry. 

Time  Control :  Set  up  model  simulation,  ramp  time,  and  hydrodynamic  time 
step. 

Output  Control'.  Specify  type  and  timing  of  hot  start  files,  provide  names  for 
global  files;  provide  specifications  for  numerical  station  output. 

Tidal  Constituents'.  Specify  the  amplitude  and  phase  of  tidal  constituents  if 
applied  as  boundary  forcing. 

A  full  description  is  provided  for  each  dialog. 
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Figure  25.  CMS-M2D  Model  Control:  Model  Control  dialog 


The  Model  Control  dialog  contains  three  areas:  Input  Files  Options, 
Sediment  Transport,  and  Wave  Data. 

Input  file  options.  Although  not  required,  externally  generated  input  files 
can  be  accessed  in  the  simulation.  By  turning  on  the  toggle  next  to  each  input 
file  type,  an  existing  file  can  be  selected  by  clicking  on  the  File  Browse  button. 
Alternatively,  the  user  can  manually  create  the  input  file  by  clicking  on  the 
button  to  the  right  that  identifies  each  file  type.  For  example,  in  Figure  25,  an 
input  file  for  time  specification  of  vector  plot  output  will  be  read  by  CMS-M2D, 

and  it  is  called  “Flume _ m2d_V.m2t.”  Alternatively,  the  user  can  specify  the 

time  stamp  information  by  entering  the  Choose  Time...  dialog. 

Initial  conditions  (*.m2i).  The  initial  conditions  file  contains  a  line  for 
every  cell  in  the  grid  containing  information  on  the  state  of  each  cell.  This 
information  includes  cell  identification  number,  depth,  water-surface  elevation, 
u-  and  v-components  of  velocity,  suspended  sediment  concentration,  dv\  /  dt  at 
interior  cells  (boundary  cells  have  value  of  0.0),  dr\  /  dt  at  boundary  cells 
(interior  cells  have  value  of  0.0),  u  ’  and  v’  (solutions  of  Equations  291  and  296). 
A  full  description  of  the  initial  conditions  file  is  given  in  Chapter  9. 

Wind  (*.m2w).  The  wind  file  contains  a  list  of  time  steps  containing  wind 
magnitude  and  direction.  Each  line  contains  three  values:  time  (hours), 
magnitude  (m/s),  direction  from  which  the  wind  is  blowing  (deg).  Wind 
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directions  are  referenced  as  from  north  =  0  deg,  from  east  =  90  deg,  etc.  Note 
that  this  wind  direction  convention  is  different  from  the  convention  described  for 
the  governing  equations  (Chapter  2).  CMS-M2D  converts  the  wind  velocity 
from  the  input  file  convention  to  the  computation  convention  internally.  Clicking 
the  Wind  Control  button  brings  up  a  dialog  where  wind  magnitude  and  direction 
time  series  can  be  specified. 

Time  specification  for  vector  plot  output  (*_V.m2t).  The  Time 
Specification  dialog  allows  the  user  to  specify  time  stamps  for  global  solution 
output  (in  hours).  Vector  plot  output  time  specification  corresponds  to  the  global 
velocity  and  transport  rate  solution  files  (*.m2v).  Time  increments  between 
global  output  can  vary,  allowing  the  user  to  have  more  or  less  frequent  output. 

Time  specification  for  global  elevation  output  (*_E.m2t).  The  Time 
Specification  dialog  allows  the  user  to  specify  time  stamps  for  global  solution 
output  (in  hours).  Scalar  plot  output  time  specification  is  associated  with  the 
times  at  which  CMS-M2D  will  write  out  the  global  elevation  and  global  depth 
files  (*.m2s).  Time  increments  between  global  output  can  vary,  allowing  the 
user  to  have  more  or  less  frequent  output. 

Sediment  transport.  The  Calculate  sediment  transport  option  allows  the 
user  to  execute  sediment  transport  and  morphology  change  calculations.  By 
clicking  Calculate  sediment  transport,  file  name  options,  sediment  transport 
time  steps,  and  transport  formulation  options  become  available. 

Global  bottom  change  prefix  (*.m2s).  The  Global  bottom  change  prefix  is 
the  prefix  of  the  file  name  that  will  contain  the  global  depth  information  (in 
hours),  as  computed  by  the  morphology  change  calculations.  An  extension  of 
“.m2s”  is  appended  to  the  specified  prefix.  This  global  output  file  will  be  written 
at  time  stamps  contained  in  the  file  specified  by  the  Time  specification  for  global 
elevation.  The  global  depth  file  format  contains  a  line  with  the  time  step, 
followed  by  subsequent  lines  for  each  grid  cell  with  three  values:  x-position  in 
present  coordinate  system,  y-position  in  present  coordinate  system,  and  depth. 
Position  values  have  units  of  meters  and  depth  values  have  units  of  meters. 

Global  transport  rate  prefix  (*.m2v).  The  Global  transport  rate  prefix  is 
the  prefix  of  the  file  name  that  will  contain  the  global  total  transport  rate 
information  (in  hours).  An  extension  of  “.m2v”  is  appended  to  the  specified 
prefix.  This  global  output  file  will  be  written  at  time  stamps  contained  in  the  file 
specified  by  the  Time  specification  for  vector  plot.  Two  total  load  global 
transport  rate  files  will  be  written.  Instantaneous  transport  rates  are  written  to  a 
file  having  the  Global  transport  rate  prefix ,  and  averaged  transport  rates  (over 
time  interval  of  dtmorph )  are  written  to  a  file  having  “AVG”  appended  to  the 
Global  transport  rate  prefix.  If  the  Lund-CIRP  total  load  formulation  or  the  AD 
equation  is  selected  for  sediment  transport  calculations,  two  additional  global 
transport  rate  files  are  written,  one  for  instantaneous  bed  load  transport  and  one 
for  instantaneous  suspended  load.  File  names  for  the  bed  load  and  suspended 
load  files  have  “BED”  and  “SUS”  appended  to  the  Global  transport  rate  prefix. 
Note  that,  if  hard-bottom  cells  are  present,  the  averaged  total  load  transport  rates 
that  are  saved  to  the  file  containing  “AVG”  have  been  adjusted  to  account  for 
transport  rate  modifications  owing  to  the  presence  of  non-erodible  substrate,  but 
the  instantaneous  values  contained  in  the  remaining  transport  rate  files  contain 
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the  potential  transport  rate  values.  The  global  transport  rate  file  format  contains  a 
line  with  the  time  step,  followed  by  subsequent  lines  for  each  grid  cell  with  four 
values:  x-position  in  present  coordinate  system,  y-position  in  present  coordinate 
system,  x-directed  transport  rate,  and  y-directed  transport  rate.  Position  values 
have  units  of  meters,  and  transport  rate  values  have  units  of  m3/s/m. 

Transport  rate  time  step.  The  Transport  rate  time  step  is  the  time  interval 
at  which  instantaneous  sediment  transport  rates  are  computed  in  the  total  load 
formulations,  and  is  the  time  interval  at  which  the  AD  equation  is  solved  and 
instantaneous  transport  rates  computed  if  the  AD  formulation  is  applied.  The 
transport  rate  time  step  has  units  of  seconds. 

Morphologic  time  step.  The  Morphologic  time  step  is  the  time  interval  at 
which  morphology  change  is  calculated  and  the  depth  is  updated.  The 
morphologic  time  step  has  units  of  hours. 

Formulation.  If  sediment  transport  is  invoked,  the  user  must  select  a 
transport  formulation  to  apply.  Formulation  options  are:  Lund-CIRP  total  load, 
Watanabe  total  load,  and  AD  equation  and  each  option  can  be  selected  by 
clicking  the  radio  button  adjacent  to  it.  Options  specific  to  each  formulation  are 
accessed  by  clicking  on  the  Formulation  Options  button.  Specific  parameters 
(Figure  26)  include  the  median  particle  size,  sediment  density,  and  water  density 
for  all  formulations.  Each  formulation  also  includes  other  parameters  as  shown. 


Figure  26.  CMS-M2D  Sediment  Transport  Option  dialogs 


Wave  data.  Information  calculated  by  a  wave  model  can  be  entered  as  input 
to  CMS-M2D  in  this  section.  The  Include  STWAVE  radiation  stresses  box 
should  be  checked  only  if  a  radiation-stress  gradient  file  is  available  for  CMS- 
M2D  to  read  in  directly  and  the  Steering  Module  is  not  invoked.  This  already- 
existing  file  can  be  selected  by  clicking  on  the  File  Browse  button.  If  the 
Steering  Module  is  to  be  run,  do  not  check  the  Include  STWA  VE  radiation 
stresses  box  as  SMS  will  do  this  automatically  as  files  become  available.  All 
other  wave  properties  can  be  included  in  a  simulation  by  checking  the  Wave 
Conditions  box.  If  the  Wave  Conditions  box  is  checked,  CMS-M2D  will  read 
files  containing  wave  height,  period,  direction,  breaking  index,  and  dissipation. 


102 


Chapter  8  Surfacewater  Modeling  System  Interface  for  CMS-M2D 


Radiation  stress  file  (*.m2v).  The  radiation  stress  file  contains  the  global 
radiation-stress  gradient  information  (in  hours).  An  extension  of  “.m2v”  is 
customary  for  this  file  as  it  includes  vector  information,  and  the  SMS  applies  this 
extension  to  radiation-stress  gradient  files  when  creating  them  in  the  Steering 
Module.  During  Steering  simulations,  the  SMS  writes  radiation-stress  gradient 
files  for  CMS-M2D  that  have  values  at  time  steps  equal  to  the  steering  interval. 
The  global  radiation-stress  gradient  file  format  contains  a  line  with  the  time  step, 
followed  by  subsequent  lines  for  each  grid  cell  with  four  values:  x-position  in 
present  coordinate  system,  y-position  in  present  coordinate  system,  x-directed 
radiation-stress  gradient,  and  y-directed  radiation-stress  gradient.  Position  values 
have  units  of  meters  and  radiation-stress  gradient  values  have  units  of  m2/s2. 

The  Model  Parameters  tab  of  the  Model  Control  dialog  (Figure  27)  contains 
four  areas:  Miscellaneous  Parameters,  Momentum  Equation,  Wall  Friction,  and 
Wetting  and  Drying. 

Miscellaneous  Parameters.  This  area  of  the  dialog  allows  the  user  to 
specify  parameters  relating  to  wind  and  Coriolis  calculations. 

Anemometer  height.  If  wind  is  specified,  the  height  of  the  anemometer  is 
required.  The  standard  anemometer  height  is  10  m,  and  this  is  the  default  value 
provided  by  SMS.  If  measurements  were  taken  with  an  anemometer  at  a 
different  height,  this  height  should  be  entered  here  so  that  CMS-M2D  will 
convert  the  wind  speed  to  wind  speed  at  10  m.  Units  for  anemometer  height  are 
meters. 


Figure  27.  CMS-M2D  Model  Control:  Model  Parameters  dialog 

Rho_atm/Rho_water.  Ratio  of  density  of  air  to  density  of  water.  The 
default  value  is  0.0012  and  generally  should  not  be  modified. 
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Latitude  throughout  Grid.  CMS-M2D  applies  the  cell-specific  latitude  to 
compute  the  Coriolis  term  in  the  momentum  equations.  If  a  standard  coordinate 
system  is  specified  for  a  CMS-M2D  grid,  such  as  State  Plane  or  UTM,  the  SMS 
will  determine  the  latitude  at  the  center  of  each  CMS-M2D  cell.  If  a  local  (user- 
defined)  coordinate  system  is  specified,  the  SMS  does  not  have  sufficient 
information  to  determine  the  cell  latitudes.  If  cell  latitudes  cannot  be  determined 
by  the  SMS  or  if  the  user  prefers  to  apply  a  single  value  of  latitude  over  the  grid, 
then  a  value  for  Average  latitude  can  be  entered  that  will  be  applied  over  the 
entire  grid.  Setting  the  latitude  to  zero  over  the  entire  grid  will  turn  the  Coriolis 
term  off. 

Momentum  Equation.  This  area  of  the  dialog  allows  the  user  to 
independently  turn  on  or  off  the  advective  and  mixing  terms  in  the  momentum 
equations.  To  include  the  advective  terms,  the  box  adjacent  to  Include  advective 
terms  must  be  checked.  To  include  the  mixing  terms,  the  box  adjacent  to  Include 
mixing  terms  must  be  checked. 

Wall  Friction.  This  area  of  the  dialog  allows  the  user  to  invoke  wall 
friction,  which  is  increased  friction  at  cells  having  at  least  one  wall.  If  the  box 
adjacent  to  Include  wall  friction  is  checked,  wall  friction  will  be  included  in  the 
calculations. 

Wetting  and  Drying.  This  area  of  the  dialog  allows  the  user  to  specify  the 
depth,  in  meters,  at  which  CMS-M2D  treats  cells  as  dry.  Typical  values  lie  in  the 
range  of  0.03  to  0.08  m. 

The  Time  Control  tab  of  the  Model  Control  dialog  (Figure  28)  allows 
specification  of  the  start  date  and  time,  simulation  duration,  ramp  duration,  and 
the  time  step.  SMS  can  compute  a  theoretical  maximum  time  step  based  on 
celerity.  Practical  application  of  CMS-M2D  requires  that  the  time  step  be  less 
than  the  theoretical  maximum.  A  general  guideline  is  to  set  the  time  step  to  half 
of  the  theoretical  maximum,  and  then  adjust  the  time  step  according  to  the 
hydrodynamic  properties  of  the  simulation. 

Time  Variables.  This  area  of  the  dialog  allows  the  user  to  specify  time 
variables.  The  Start  Date  and  Start  Time  are  optional  entries  that  do  not  affect 
the  model  computations  or  timing.  The  Start  Date  and  Start  Time  are  used  only 
to  calculate  Julian  Day  values  for  time  stamps  for  numerical  station  output. 

Simulation  Duration.  The  simulation  duration  is  the  total  time  for 
simulation.  For  example,  if  a  simulation  is  to  be  run  for  30  days,  then  a  value  of 
720  hr  is  entered  for  the  simulation  duration.  Simulation  duration  is  given  in 
hours. 

Ramp  Duration.  The  ramp  duration  is  the  amount  of  time  specified  for 
model  spin-up.  A  typical  ramp  duration  for  an  applied  project  is  1  day.  Ramp 
duration  is  given  in  days. 

The  Output  Control  dialog  (Figure  29)  provides  options  for  hot  starts,  global 
output  files,  and  numerical  station  output  files. 
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Figure  28.  CMS-M2D  Model  Control:  Time  Control  dialog 


Figure  29.  CMS-M2D  Model  Control:  Output  Control  dialog 
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Hot  Start.  Two  independent  hot  start  options  are  available  for  CMS-M2D. 
Checking  the  Write  Hot  Start  Output  File  box  allows  the  user  to  specify  a  time  at 
which  a  file  of  the  same  format  as  the  initial  conditions  file  will  be  written.  The 
hot  start  file  can  be  later  used  as  an  initial  conditions  file  for  subsequent  model 
runs.  The  user  specifies  a  prefix  for  the  hot  start  file  name  and  the  elapsed  time, 
in  hours,  at  which  the  file  will  be  written.  By  checking  the  Automatic  Recurring 
Hot  Start  File  box  and  providing  a  time  interval  (hours),  hot  start  files  will  be 
written  at  the  time  interval  specified.  Hot  start  files  are  written  with  file  names 
alternating  with  HOTSTART1.M2I  and  HOTSTART2.M2I.  These  files  can  be 
later  input  as  initial  conditions  files  for  a  subsequent  simulation.  The  file 
HOTSTART.INFO  is  also  written  and  contains  the  name  (HOTSTART1.M2I  or 
HOTSTART2.M2I)  and  time  of  the  last  saved  hot  start  file. 

Output  Files.  Global  velocity  and  elevation  output  file  names  are  specified 
in  this  section  of  the  dialog.  CMS-M2D  supports  two  types  of  global  output, 
vector  and  scalar  for  each  cell  in  the  grid.  Traditionally  this  output  has  been 
stored  in  ASCII  files  defined  for  the  model.  These  ASCII  files  (described 
below),  can  become  very  large.  Another  option  added  in  this  version  of  the 
model  is  to  save  the  same  output  into  a  binary  formatted  XMDF  file.  The  user 
can  elect  to  save  ASCII,  Binary,  or  both  file  types  by  checking  the  boxes  for 
“Output  ASCII”  and/or  “Output  Binary.”  Description  of  the  XMDF  formats  can 
be  found  at  http://www.wes.army.mil/ITL/XMDF. 

Global  velocity  (*.m2v).  By  checking  this  toggle  box,  a  global  velocity 
solution  will  be  written  out  by  CMS-M2D  at  the  times  specified  in  the  CMS- 
M2D  Output  Time  Specification  dialog  for  Vector  Plot.  The  file  extension 
“.m2v”  is  appended  to  the  prefix  specified.  The  global  velocity  file  format 
contains  a  line  with  the  time  step,  followed  by  subsequent  lines  for  each  grid  cell 
with  four  values:  x-position  in  present  coordinate  system,  y-position  in  present 
coordinate  system,  ^-component  of  velocity,  and  v-component  of  velocity. 
Position  values  have  units  of  meters  and  velocity  values  have  units  of  meters  per 
second. 

Global  elevation  (*.m2s).  The  explanation  provided  for  Global  velocity 
applies  here  as  well,  with  the  difference  being  that  a  global  elevation  solution 
will  be  written  out.  The  global  elevation  file  format  is  the  same  as  that  of  the 
global  velocity  solution  file,  with  the  exception  that  the  u-  and  v-component 
velocity  values  are  replaced  by  the  water  level  in  meters  at  each  cell. 

Time  Series  Output  Files.  This  section  allows  the  user  to  specify  output 
options  for  numerical  stations  where  water-surface  elevation  and/or  velocity  are 
to  be  saved  at  equal  time  increments.  A  prefix  for  the  file  containing  the 
numerical  station  output  must  be  specified.  The  file  extension  “.m2o”  is 
appended  to  the  specified  prefix.  Entering  a  non-zero  time  increment,  in 
seconds,  provides  the  output  timing.  Note  that  this  time  increment  should  be  an 
integer  multiple  of  the  hydrodynamic  time  step.  Check  the  variables  that  are  to 
be  output  (w,  v,  or  r|).  The  “.m2o”  output  file  will  contain  a  header  line  that 
indicates  that  the  first  column  of  information  is  the  time  stamp  (in  Julian  Day  or 
elapsed  time  in  days),  and  the  list  of  cells  at  which  time  series  values  are  output. 
The  second  and  following  lines  contain  the  time  stamp  in  the  first  column, 
following  by  values  for  each  numerical  station. 
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Flow  Rate  Output  Files.  This  section  allows  the  user  to  specify  output 
options  for  numerical  stations  where  directional  components  of  the  flow  rate  are 
to  be  saved  at  equal  time  increments.  A  prefix  for  the  file  containing  the 
numerical  station  output  must  be  specified.  The  file  extension  “.m2o”  is 
appended  to  the  specified  prefix.  Entering  a  non-zero  time  increment,  in 
seconds,  provides  the  output  timing.  Note  that  this  time  increment  should  be  an 
integer  multiple  of  the  hydrodynamic  time  step.  Check  the  directional  flow 
components  that  are  to  be  output  (x  and/or  y-directed  flow  rate).  The  “.m2o” 
output  file  will  contain  a  header  line  that  indicates  that  the  first  column  of 
information  is  the  time  stamp  (in  Julian  Day  or  elapsed  time  in  days),  and  the  list 
of  cells  at  which  time  series  values  are  output.  The  second  and  following  lines 
contain  the  time  stamp  in  the  first  column,  following  by  values  for  each 
numerical  station. 

The  Tidal  Constituents  dialog  (Figure  30)  allows  the  user  to  select  up  to  eight 
tidal  constituents  to  apply  as  forcing  in  CMS-M2D.  The  user  must  specify  the 
local  amplitude  and  phase  of  each  tidal  constituent.  Amplitude  and  phase  is  held 
spatially  constant  along  an  entire  cell  string  for  each  tidal  constituent.  Phase 
must  be  specified  in  the  same  time  zone  as  other  model  inputs.  Amplitude  and 
phase  values  for  the  eight  constituents  can  often  be  obtained  from  National 
Ocean  Service  harmonic  analysis  for  local  water-level  gauges. 


Figure  30.  CMS-M2D  Model  Control:  Tidal  Constituents  dialog 
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Run  CMS-M2D 

The  Run  CMS-M2D  command  makes  sure  the  current  simulation  is  saved  to 
disk,  and  launches  CMS-M2D  to  run  the  present  simulation.  The  SMS  also 
performs  a  model  check  before  launching  the  model.  If  any  anomalies  are 
detected,  a  warning  is  issued. 

Steering  Module 

Coupling  of  CMS-M2D  with  STWAVE  (or  WABED)  is  conducted  through 
the  Steering  Module.  This  feature  controls  interaction  of  the  two  models  by 
alternating  STWAVE  and  CMS-M2D  runs  for  a  specified  time  called  the 
Steering  Interval,  and  provides  mapped  fields  of  variables  to  each  model.  The 
user  controls  the  steering  options  by  checking  boxes  in  the  Steering  Module 
dialog  for  each  type  of  interaction  needed  for  the  specific  simulation  (Figure  31). 

To  invoke  the  Steering  Module,  CMS-M2D  and  STWAVE  (or  WABED) 
grids  must  be  loaded  into  SMS.  All  inputs  and  options  for  both  models  must  be 
specified  before  launching  the  steering  process.  Users  should  consult  the 
STWAVE  User’s  Manual  (Smith  et  al.  1999,  2001)  for  information  on  setting  up 
STWAVE  in  SMS.  WABED  can  be  set  up  with  the  same  tools  and  conventions 
as  STWAVE. 

The  Steering  Module  dialog  is  opened  from  the  Data  drop-down  menu 
(Figure  31).  The  steering  interval  is  set  by  specifying  the  time  requested  by  the 
“Run”  inquiry.  Interaction  between  the  models  is  selected  by  clicking  the 
available  options  in  the  CMS-M2D^  STWAVE/WABED  (meaning  CMS-M2D 
passes  velocities  and/or  total  depth  to  STWAVE  or  WABED)  and 
STWAVE/WABED->CMS-M2D  (meaning  STWAVE  or  WABED  passes  wave 
information  to  CMS-M2D)  portions  of  the  dialog.  If  sediment  transport 
calculations  are  invoked,  the  Steering  Module  will  always  pass  updated  depths 
from  CMS-M2D  to  STWAVE  or  WABED  so  that  modifications  of  the  waves 
owing  to  morphology  change  will  be  taken  into  account.  If  the  “Wave 
Conditions”  box  is  checked  in  the  CMS-M2D  Model  Control  dialog  (Figure  25), 
the  Steering  Module  will  map  fields  of  wave  properties  (height,  period,  wave 
direction,  breaking  index,  and  wave  dissipation)  to  the  CMS-M2D  grid  for 
inclusion  in  hydrodynamic  and  sediment  transport  calculations. 

After  the  Steering  Module  setup  is  complete,  clicking  Start  invokes  the 
steering  process.  If  the  SMS  detects  that  a  previous  steering  run  has  been 
conducted  for  the  present  project,  a  Restart  Options  (Figure  32)  dialog  will  pop 
up  to  allow  the  user  to  specify  whether  to  continue  the  previous  steering 
simulation  or  start  at  the  beginning  of  the  steering  process.  If  the  user  chooses  to 
restart  from  a  previous  steering  simulation,  the  dialog  allows  options  to  select 
which  model  simulation  and  steering  interval  to  start  from.  Once  the  steering 
process  has  been  initiated,  a  progress  screen  will  be  shown. 

During  steering,  the  SMS  creates  two  output  files  that  provide  information  on 
the  steering  process  and  on  the  model  progress.  The  file  “steeringstatus.txt” 
provides  information  on  the  steering  options  and  status  of  the  steering  process. 
The  file  “screenoutput.txt”  contains  text  that  CMS-M2D  and  STWAVE  or 
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WABED  write  to  the  screen.  If  the  steering  simulation  is  unsuccessful,  the  user 
is  advised  to  examine  these  two  files  to  help  determine  the  source  of  the  problem. 


Figure  31 .  Steering  Module  dialog 


Figure  32.  Steering  Module  Restart  Options  dialog 


Saving  a  Project 

During  development  of  a  project  within  the  SMS,  numerous  sets  of 
information  may  be  brought  in  and  applied  to  grid  development  and  simulation 
setup.  It  is  common  for  a  CMS-M2D  project  to  contain  bathymetric  data,  Map 
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Module  information  such  as  a  grid  frames  and  refine  points,  a  CMS-M2D  grid 
and  model  setup,  an  STWAVE  or  WABED  grid  and  model  setup,  and  an 
ADCIRC  (or  other  regional  model)  mesh  and  solution  files  from  which  CMS- 
M2D  boundary  conditions  have  been  extracted.  In  addition,  the  coordinate 
system  in  which  the  grids  have  been  developed  is  contained  with  the  SMS 
information.  The  SMS  will  save  all  of  the  information  collectively  as  a  project 
by  using  the  Save  Project  option  or  Save  As  and  then  choosing  the  “.sms” 
option.  When  saved  as  a  project,  SMS  will  create  a  master  project  file  with  the 
“.sms”  extension  that  saves  all  information  related  to  the  project.  When  a  project 
file  is  loaded  into  SMS,  all  scatter  data,  map  information,  and  models  that  were 
previously  contained  in  the  project  will  be  loaded. 

The  user  may  opt  to  save  information  specific  to  a  particular  module  or 
model.  For  example,  to  save  a  CMS-M2D  model  setup,  the  SMS  will  issue  a 
Save  M2D  command  from  the  File  drop-down  menu  if  a  CMS-M2D  simulation 
is  selected  in  the  Data  Tree. 
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9  Model  Setup  and  File 
Structure 


Setup  of  CMS-M2D  requires  development  of  a  computational  grid  and 
preparation  of  one  or  more  input  files.  The  SMS  creates  all  model  input  files  in 
the  correct  format  so  that  editing  or  input  file  generation  is  generally  not 
required.  The  exceptions  to  this  are  preparation  of  time  series  of  wind  speed  and 
direction,  water  level,  or  flow  rate  files  for  input  as  forcing.  These  files  can  be 
created  within  the  SMS,  but  often  the  user  already  possesses  data  from  which 
these  files  are  developed.  This  section  describes  the  structure  of  files  required  to 
run  the  CMS-M2D  model  and  its  output  files  to  assist  the  user  in  understanding 
the  file  formats.  All  input  and  output  files  to  CMS-M2D  are  ASCII.  Unless 
otherwise  noted,  files  are  free  format. 

Input  Files 

Required  input  files  for  CMS-M2D  are  the  grid  file,  control  file,  and  one  or 
more  forcing  files  (boundary  conditions,  wind  input,  or  radiation-stress  gradient 
input).  A  particular  simulation  may  require  additional  input  files  that  can  include 
any  combination  of  initial  conditions,  water-level  time  series,  flow  rate  time 
series,  tidal  constituents,  wind  speed  and  direction,  waves  stress,  wave  properties, 
sediment  transport  options  and  parameters,  specifications  for  non-erodible  cells, 
and  output  specification.  Structures  of  these  input  files  are  described  here. 
Sample  files  are  provided  in  Appendix  A. 

Grid  file 

The  grid  file  for  CMS-M2D  is  structured  such  that  all  information  pertaining 
to  a  cell  is  found  on  the  same  line  as  the  cell  identification  number.  This  format 
is  convenient  for  the  user  so  that  once  a  cell  is  located  in  the  grid  file,  its 
properties  are  easily  viewed.  The  grid  file  contains  some  information  that  is  not 
used  within  CMS-M2D,  but  is  retained  for  user  reference  and  post-processing. 

The  first  line  of  the  grid  file  is  a  header  line  that  describes  the  columns  of 
information  that  make  up  the  grid.  All  lines  after  the  first  specify  cell 
information.  Cells  are  defined  by  their  cell  identification  number  and  the  cell 
numbers  of  adjacent  cells,  referred  to  by  local  direction  (north,  east,  south,  west). 
These  directions  are  relative  to  the  local  (grid)  coordinate  system  defined  by  the 
grid,  which  may  or  may  not  be  aligned  with  global  geographic  coordinates.  With 
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respect  to  the  local  grid  system,  north  refers  to  the  positive  y  direction  and  east 
refers  to  the  positive  x  direction. 

Each  line  describing  a  cell  consists  of  the  following  information: 


Cell  number,  NC,  EC,  SC,  WC,  NB,  EB,  SB,  WB,  IACTV,  DX,  DY,  H,  N, 
ROW,  COL,  LAT,  X-DIST,  Y-DIST 

Descriptions  of  parameters  are  given  in  Table  4  and  details  of  the  cell  activity 
parameter  (IACTV)  are  given  in  Table  5. 


Table  4 

Definitions  of  Parameters  in  Grid  File 

Parameter 

Description1 

Cell  Number 

Cell  identification  number  (referred  to  as  ICELL  within  CMS-M2D) 

NC 

Cell  number  of  cell  adjacent  to  and  north  of  ICELL 

EC 

Cell  number  of  cell  adjacent  to  and  east  of  ICELL 

SC 

Cell  number  of  cell  adjacent  to  and  south  of  ICELL 

WC 

Cell  number  of  cell  adjacent  to  and  west  of  ICELL 

NB 

Boundary  type  at  northern  edge  of  ICELL 

EB 

Boundary  type  at  eastern  edge  of  ICELL 

SB 

Boundary  type  at  southern  edge  of  ICELL 

WB 

Boundary  type  at  western  edge  of  ICELL 

IACTV 

Cell  type  or  active  status 

DX 

Cell  width  parallel  to  the  x-axis  (m) 

DY 

Cell  width  parallel  to  the  y-axis  (m) 

H 

Still-water  depth  relative  to  a  user-specified  datum  (m) 

N 

Manning  roughness  coefficient  (m/s1/3) 

ROW 

Row  position  of  cell2 

COL 

Column  position  of  cell2 

LAT 

Latitude  (decimal  degrees) 

X-DIST 

X  coordinate  or  distance  from  grid  origin  (m)3,4 

Y-DIST 

Y  coordinate  or  distance  from  grid  origin  (m)3,4 

1.  Directional  description  (north,  east,  south,  west)  refers  to  the  grid  coordinate  system. 

2.  Parameter  is  not  applied  in  CMS-M2D  calculations. 

3.  Parameter  is  not  applied  in  CMS-M2D  calculations,  but  is  written  in  global  output  files. 

4.  Coordinates  are  located  at  cell  centers. 
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Table  5 

Cell  Types  and  Their  Function  in  CMS-M2D 

Type 

Index 

(IACTV) 

Type 

Function 

0 

Inactive 

Cell  not  included  as  part  of  calculation  domain. 

1 

Active  regular  cell 

Non-forcing,  regular  cell. 

2,6 

Water-level  forcing  boundary  cell 

Water  level  specified  as  a  boundary  condition  at 
this  cell.  Type  indices  of  2  and  6  denote 
whether  the  forcing  file  contains  an  individual 
time  series  (Type  Index  =  2)  or  multiple  time 
series  (Type  Index  =  6). 

3 

Flow-rate  forcing  boundary  cell 

Flow  rate  specified  as  a  boundary  condition  at 
this  cell. 

5 

Tidal-constituent  forcing  boundary 
cell 

Water-level  specified  through  tidal  constituents 
as  a  boundary  condition  at  this  cell. 

7 

Mixed  water-level  and  velocity 
forcing  cell 

Water  level  and  velocity  applied  as  boundary 
condition  at  this  cell.  Requires  multiple  time 
series  file. 

Cell-center  coordinates  (x-dist  and  y-dist)  can  be  given  in  any  Cartesian 
coordinate  system,  such  as  State  Plane  or  UTM.  CMS-M2D  does  not  apply  the 
cell-center  coordinates  in  calculations,  but  does  export  the  values  in  global  files 
of  water-surface  elevation  and  velocity.  Because  no  specific  coordinate  system  is 
required,  the  user  can  apply  a  coordinate  system  that  is  convenient  for  the 
particular  application. 

A  grid  file  is  required  for  all  CMS-M2D  projects.  SMS  saves  CMS-M2D 
grid  files  with  the  extension  “.m2g.” 

Model  control 

Model  control  specifications  are  defined  in  an  input  file  called  “m2d.m2c”  or 
“projectname.m2c”  where  “projectname”  is  given  to  SMS  by  the  user.  SMS 
saves  the  control  file  as  “m2d.m2c”  and  as  “projectname.m2c.”  Each  line  of  the 
control  file  contains  the  parameter  or  character  string  followed  by  a  description. 
The  description  is  informational  and  CMS-M2D  does  not  read  it.  File  names  for 
input  and  output  are  user  specified  for  CMS-M2D,  with  the  exception  of  the 
alternating  hot-start  files,  and  are  listed  as  input  parameters  in  the  control  file. 
Names  of  files  are  limited  to  50  characters  and  cannot  contain  spaces.  There 
must  be  at  least  one  space  between  the  parameter  or  character  string  and  the 
description.  Information  contained  in  the  control  file  is  listed  in  Table  6  in  the 
required  order.  The  format  of  the  control  file  is  the  same  for  all  model  and 
project  configurations.  All  parameters  listed  in  Table  6  must  be  included  in  the 
control  file. 

Two  types  of  output  files  can  be  specified:  time-series  of  variables  at 
specified  cells,  and  global  values  of  variables  at  specified  times.  To  specify 
time-series  of  variables,  cell  numbers  are  identified  at  locations  to  output 
information  and  a  separate  file  is  created  to  save  each  variable.  Files  denoted  in 
Table  6  as  “Cell-specification  files”  list  cell  identification  numbers  at  which  time 
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series  information  is  stored.  Each  line  of  a  cell-specification  file  contains  one 
cell  identification  number. 


Files  denoted  in  Table  6  as  “Time-specification  files”  are  for  global  velocity 
and  elevation  output,  and  contain  a  list  of  times  to  save  data.  Times  are  specified 
as  elapsed  hours  since  the  beginning  of  the  simulation.  Each  line  in  the  file 
contains  one  value  of  time  and  times  must  be  in  sequential  order.  The  interval 
between  successive  outputs  can  vary  through  the  simulation.  For  example,  a  time 
specification  file  may  have  output  times  prescribed  as  0,  1,  2,  2.5,  3,  3.5,  4,  4.25, 
and  5  hr. 


Table  6 

Model  Control  File  Specifications 

Parameter 

Description 

Version 

CMS-M2D  Version  number 

Anemometer  height  (m) 

Height  of  anemometer  above  water  or  land 
surface 

Output  file  format 

Specification  of  CMS-M2D  output  file  type. 
Options:  BINARY,  ASCII,  or  BOTH 

Angle  between  true  north  and  y-axis  of  grid 
(deg) 

Defined  by  grid  orientation 

Grid  origin  x-coordinate 

Location  of  x  position  of  cell  1 

Grid  origin  y-coordinate 

Location  of  y  position  of  cell  1 

Time  step  (s) 

Model  time  step 

Automated  hot-start  interval  (hr) 

Time  interval  between  automated  hot-start  file 
writes 

Include  advective  terms 

Flag  for  inclusion  of  advective  terms  in  the 
momentum  equation.  Flag  settings:  0  =  do  not 
include,  1  =  include 

Include  mixing  terms 

Flag  for  inclusion  of  mixing  terms  in  the 
momentum  equation.  Flag  settings:  0  =  do  not 
include,  1  =  include 

Include  wall  friction 

Flag  for  calculation  of  wall  friction  at  cells  with 
wall  faces.  Flag  settings:  0  =  do  not  calculate 
wall  friction,  1  =  calculate  wall  friction. 

Depth  (m)  to  begin  drying  cells 

Drying  will  occur  if  the  total  depth  in  a  cell  is 
less  than  or  equal  to  the  depth  specified  here. 

Calculate  sediment  transport 

Flag  for  calculation  of  sediment  transport.  Flag 
settings:  0  =  do  not  calculate,  1  =  calculate 

Starting  Julian  Day  (YYDDD  OR  DDD) 

Date  of  beginning  of  simulation 

Start  time  (hr) 

Time  of  beginning  of  simulation 

Realization  time  (hr) 

Duration  of  simulation 

Ramp  duration  (day) 

Duration  of  ramp 

(Sheet  1  of  3) 
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Table  6  (Continued) 

Parameter 

Description 

Steering  Module  elapsed  time 

Cumulative  time  at  beginning  of  present 
simulation;  applied  for  multiple  simulations  with 
Steering  Module 

Time  to  write  output  for  hot-start  (hr) 

Time  when  hot  start  output  is  to  be  written. 

Use  a  value  of  0  if  no  hot-start  information  is  to 
be  saved. 

Grid  file  name 

Name  of  grid  file  (required) 

Initial  conditions  file  name 

Name  of  file  containing  initial  conditions.  If 
starting  the  simulation  from  quiescent 
conditions,  use  “default”  (without  the  quotes) 
instead  of  a  file  name. 

Tidal  constituents  file  name 

Name  of  file  containing  tidal  constituents. 

Wind  input  file  name 

Name  of  file  containing  wind  speed  and 
direction  (required). 

Include  radiation  stresses 

Flag  for  inclusion  of  radiation  stress  forcing. 

Flag  settings:  0  =  no  radiation  stress  forcing, 

1  =  include  radiation  stress  forcing. 

Wave  properties  file 

Name  of  a  file  containing  the  names  of  wave- 
properties  files  for  height,  period,  direction, 
breaking,  and  dissipation1. 

Radiation  stress  file 

Name  of  radiation  stress  file1. rad. 

Hot-start  output  file  name 

Name  of  hot  start  output  file1. 

Time-specification  file  for  vector  plot  output 

Name  of  file  containing  times  for  vector  plot 
(global  u,  v)  output1. 

Time-specification  file  for  global  elevation 
output 

Name  of  file  containing  times  for  global 
elevation  output1. 

Time-series  output  cell-specification  file 

Name  of  file  containing  cell  numbers  for  time- 
series  output  of  u,  v,  rj1. 

Flow  rate  output  time-series  cell-specification 
file 

Name  of  file  containing  cell  numbers  for  flow 
rate  output1. 

Time  between  output  file  writes  (s)  for  u,  v,  rj 
time-series  file 

Time  should  be  a  multiple  of  the  simulation  time 
step. 

Time  between  output  file  writes  (s)  for  flow-rate 
file 

Time  should  be  a  multiple  of  the  simulation  time 
step. 

Time-series  output  file  for  u 

Name  of  file  to  contain  u  time  series1. 

Time-series  output  file  for  v 

Name  of  file  to  contain  vtime  series1. 

Time-series  output  file  for  rj 

Name  of  file  to  contain  r\  time  series1. 

Flow  rate  output  file  for  Qx 

Name  of  file  to  contain  time  series  of  Qx. 

Flow  rate  output  file  for  Qy 

Name  of  file  to  contain  time  series  of  Qy\ 

Prefix  for  vector  output  file  name 

CMS-M2D  appends  “.m2v”  to  the  user- 
specified  prefix  when  naming  the  vector  output 
file. 

Prefix  for  global  elevation  output  file  name 

CMS-M2D  appends  “.m2s”  to  the  user- 
specified  prefix  when  naming  the  global 
elevation  file. 

(Sheet  2  of  3) 
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Table  6  (Concluded) 

Parameter 

Description 

Prefix  for  global  depth  output  file  name 

CMS-M2D  appends  “.m2s”  to  the  user- 
specified  prefix  when  naming  the  global  depth 
file. 

Prefix  for  transport  rate  output  file  name 

CMS-M2D  appends  “.m2v”  to  the  user- 
specified  prefix  when  naming  the  global 
transport  rate  file. 

HDRIVER  file  name 

Name  of  file  containing  water-surface  elevation 
forcing  information  (individual  time-series  files). 

QDRIVER  file  name 

Name  of  file  containing  flow  rate  forcing 
information. 

MHDRIVER  file  name 

Name  of  file  containing  water-surface  elevation 
forcing  information  (multiple  time-series  files). 

MVDRIVER  file  name 

Name  of  file  containing  velocity  forcing 
information  (multiple  time-series  files). 

(Sheet  3  of  3) 

1 .  Use  “none”  or  “NONE”  if  no  hot-start  output  for  this  variable  is  specified. 

Initial  conditions 

An  initial-conditions  file  provides  information  at  the  beginning  of  the 
simulation  at  all  cells.  Each  line  in  the  initial-conditions  file  contains  15  values. 
The  first  ten  are  cell  number,  ambient  depth,  water-surface  elevation,  u-  and  v- 
components  of  velocity,  suspended  sediment  concentration,  dv\  /  dt  at  interior 
cells  (boundary  cells  have  value  of  0.0),  dv\/c )t  at  boundary  cells  (interior  cells 
have  value  of  0.0),  u  \  and  v  \  Depth  and  water  level  are  given  in  m,  velocity 
components  are  given  in  m/s,  dr\  /  dt  values  are  given  in  m/s,  and  concentration 
is  given  in  m3/m3.  The  1 1th  through  14th  values  are  the  cell  boundary  type  indices 
(Table  4),  and  the  15th  column  is  the  cell  activity  parameter  (IACTV).  CMS- 
M2D  writes  hot-start  files  in  the  correct  format  for  reading  as  initial  conditions. 

If  a  time-specific  hot  start  is  specified  within  the  SMS  model  control,  the  hot- 
start  file  name  will  have  the  extension  “.m2i.”  If  the  automatic  recurring  hot- 
start  capability  within  CMS-M2D  is  invoked,  the  hot-start  files  will  be  named 
“HOTSTART 1  .M2I”  and  “HOTSTART2.M2I.”  Automatic  hot-starts  are 
invoked  by  setting  the  hot-start  time  interval  to  a  value,  in  hours,  greater  than 
zero. 

Water-level  forcing  data  files 

Time-series  boundary  forcing  for  CMS-M2D  can  be  specified  as  water- 
surface  elevation.  Two  types  of  files  containing  water-surface  elevation  forcing 
information  can  be  applied.  One  type  contains  individual  time  series  and  the 
other  type  contains  multiple  time  series.  Both  individual  and  multiple  time  series 
forcing  can  be  applied  in  the  same  simulation.  This  capability  is  convenient  for 
situations  in  which  the  time  increment  is  not  equal  between  different  sets  of  time 
series.  This  capability  also  provides  flexibility  for  defining  multiple  water-level 
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forcing  cell  strings  within  the  SMS  and  specifying  forcing  from  various  sources. 
For  example,  a  simulation  may  require  that  one  or  more  cell  strings  are  forced  by 
data  from  a  water-level  gauge  and  use  the  individual  forcing  file,  and  also  that 
one  or  more  cell  strings  are  forced  by  water  levels  calculated  by  a  regional  model 
or  tidal-constituent  database  and  saved  in  a  multiple  time-series  file. 

CMS-M2D  recognizes  whether  time  series  of  water  level  are  specified  as 
forcing  by  identification  of  forcing  cells  in  the  grid  file.  If  time  series  water-level 
driving  cells  are  found,  CMS-M2D  opens  the  HDRIVER  and/or  MHDRIVER 
files  (see  Table  6).  The  first  line  of  the  HDRIVER  or  MHDRIVER  file  contains 
two  integer  values.  The  first  value  specifies  the  number  of  files  containing 
water-surface  elevation  forcing  time  series.  The  second  value  is  the  total  number 
of  cells  forced  by  water-surface  elevation  values  for  HDRIVER  files,  and  is  the 
maximum  number  of  cells  forced  by  water-surface  elevation  for 
MHDRIVER.DAT  files.  More  than  one  multiple  time  series  file  can  be  applied 
in  a  simulation.  The  maximum  number  of  cells  forced  by  water-surface  elevation 
is  the  greatest  number  of  cells  forced  for  all  files  listed  in  the  MHDRIVER.DAT 
file. 


The  second  line  contains  the  name  of  a  data  file  that  contains  the  forcing 
data.  The  third  line  of  the  HDRIVER  or  MHDRIVER.DAT  file  contains  the 
number  of  cells  that  are  driven  by  the  data  contained  in  the  file  listed  in  the 
second  line,  and  an  interpolation  parameter.  The  interpolation  parameter 
specifies  whether  or  not  the  forcing  data  are  interpolated  between  model  time 
steps.  For  example,  water-level  forcing  data  may  be  available  every  hour,  but  the 
model  time  step  might  be  30  s.  If  the  interpolation  parameter  is  set  to  1,  values 
of  water  level  at  the  forcing  boundaries  are  interpolated  at  each  model  time  step. 
If  the  interpolation  parameter  is  set  to  0,  no  interpolation  takes  place.  Following 
the  first  and  second  lines  a  list  of  cell  numbers  that  are  forced  by  the  time  series 
data  given  in  the  forcing  data  file.  For  the  individual  time  series  forcing  files,  all 
cells  in  the  list  are  forced  by  the  same  single  time  series.  Cells  forced  by  water 
levels  contained  in  the  multiple  time  series  file  must  be  listed  in  the 
MHDRIVER.DAT  file  in  the  order  that  their  corresponding  time  series  appear  in 
the  forcing  data  file. 

If  more  than  one  forcing  data  file  is  applied  for  water  level  or  discharge, 
information  is  specified  exactly  as  previously  described  for  all  sets  of  forcing 
data  and  placed  in  the  HDRIVER  or  MHDRIVER  file  below  the  information  for 
the  first  file. 

If  boundary  input  is  specified  as  individual  time  series  of  water-surface 
elevation  in  a  CMS-M2D  project,  the  SMS  saves  the  HDRIVER  file  name  as 
“hdriver_projectname.dat.”  If  boundary  input  is  specified  as  multiple  time-series 
of  water-surface  elevation  in  a  CMS-M2D  project,  the  SMS  saves  the 
MHDRIVER  file  name  as  ‘Tnhdriverj3rojectname.dat.” 

Files  containing  individual  time  series  water-level  forcing  data  (listed  in 
HDRIVER.DAT)  are  specified  to  have  two  values  on  each  line.  The  first  value  is 
the  time  stamp.  The  time  is  specified  in  hours  since  the  beginning  of  the 
simulation.  So,  at  t  =  0,  the  time  stamp  would  be  0.0  and  at  t  =  1  day,  the  time 
stamp  would  be  24.0.  The  second  value  is  water-surface  elevation  (m)  relative  to 
the  same  datum  as  the  grid  for  water-level  forcing  data,  or  flow  rate  (m3/s)  for 
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discharge  data.  Time  stamps  must  start  at  0.0  and  end  at  or  after  the  ending  time 
of  the  simulation. 

Files  containing  multiple  time-series  water-level  forcing  data  (listed  in 
MHDRIVER.DAT)  must  have  on  each  line  a  time  stamp  followed  by  a  water- 
level  value  for  each  of  the  cells  listed  that  correspond  to  the  particular  forcing 
file.  Thus,  if  J  cells  are  to  be  forced  with  a  particular  multiple  time  series  file, 
then  J+ 1  columns  must  be  present  in  the  forcing  file.  Columns  of  water-level 
values  must  be  listed  in  the  same  order  as  the  cell  numbers  are  listed  in  the 
MHDRIVER.DAT  file.  The  time  is  specified  in  hours  since  the  beginning  of  the 
simulation.  So,  at  t  =  0,  the  time  stamp  would  be  0.0  and  at  t  =  1  day,  the  time 
stamp  would  be  24.0.  Water-surface  elevation  (m)  is  provided  relative  to  the 
same  datum  as  the  grid  for  water-level  forcing  data.  Time  stamps  must  start  at 
0.0  and  end  at  or  after  the  ending  time  of  the  simulation. 

The  SMS  contains  dialogs  in  which  time  series  of  water-surface  elevation 
and  flow  rate  can  be  prescribed  for  CMS-M2D.  If  these  dialogs  are  accessed  to 
create  the  time  series  files,  they  will  be  saved  with  the  extension  Awl.” 

Velocity  forcing  data  files 

Forcing  by  velocity  information  can  be  applied  in  conjunction  with  the 
multiple  time  series  water-level  forcing.  The  velocity  format  is  also  a  multiple 
time  series.  Velocity  time  series  cannot  be  specified  without  water-level  forcing 
at  the  same  cells. 

CMS-M2D  recognizes  whether  time  series  of  combined  water-level  and 
velocity  values  are  applied  as  forcing  by  identification  of  forcing  cells  in  the  grid 
file.  If  time  series  combined  water-level  and  velocity  driving  cells  are  found, 
CMS-M2D  opens  the  MHDRIVER  and  MVDRIVER  files  (see  Table  6).  The 
file  format  for  the  MVDRIVER  file  is  identical  to  that  of  the  MHDRIVER  file 
described  in  the  previous  section  of  this  chapter.  SMS  saves  the  MVDRIVER 
file  as  “mvdriver_projectname.dat.” 

Files  containing  multiple  time  series  velocity  forcing  data  (listed  in 
MVDRIVER.DAT)  must  have  on  each  line  a  time  stamp  followed  by  four 
velocity  values  for  each  of  the  cells  listed  that  correspond  to  the  particular 
forcing  file.  Velocities  written  for  each  cell  are  those  on  the  cell  faces  and  are 
written  in  the  following  order:  uiefh  urighh  vtottom ,  vtop  where  the  subscripts  left , 
right ,  bottom ,  and  top  denote  the  cell  faces  in  the  grid  coordinate  system.  Thus, 
if  J  cells  are  to  be  forced  with  a  particular  multiple  time  series  file,  then  4*7+1 
columns  must  be  present  in  the  forcing  file.  Columns  of  sets  of  velocity  values 
must  be  listed  in  the  same  order  as  the  cell  numbers  are  listed  in  the 
MVDRIVER.DAT  file.  The  time  is  specified  in  hours  since  the  beginning  of  the 
simulation.  So,  at  t  =  0,  the  time  stamp  would  be  0.0  and  at  t  =  1  day,  the  time 
stamp  would  be  24.0.  Time  stamps  must  start  at  0.0  and  end  at  or  after  the 
ending  time  of  the  simulation. 

The  SMS  contains  a  dialog  in  which  time  series  of  combined  water-surface 
elevation  and  velocity  can  be  prescribed  for  CMS-M2D  in  which  the  boundary 
values  are  obtained  from  the  solution  of  a  larger-domain  model.  The  SMS 
automatically  maps  the  solution  to  the  CMS-M2D  cells. 
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Flow  rate  forcing  data  files 

Flow  rate  is  forced  by  files  containing  individual  time  series  information. 
CMS-M2D  recognizes  whether  time  series  flow  rate  values  are  applied  as  forcing 
by  identification  of  forcing  cells  in  the  grid  file.  If  time  series  flow  rate  driving 
cells  are  found,  CMS-M2D  opens  the  QDRIVER  file  (see  Table  6).  The  first  line 
of  the  QDRIVER  file  contains  two  integer  values.  The  first  value  specifies  the 
number  of  files  containing  flow  rate  forcing  time  series.  The  second  number  is 
the  total  number  of  cells  forced  by  flow  rate. 

The  second  line  contains  the  name  of  a  data  file  that  contains  the  forcing 
data.  The  third  line  of  the  QDRIVER  file  contains  the  number  of  cells  that  are 
driven  by  the  data  contained  in  the  file  listed  in  the  second  line,  and  an 
interpolation  parameter.  The  interpolation  parameter  specifies  whether  or  not  the 
forcing  data  are  interpolated  between  model  time  steps.  For  example,  flow  rate 
forcing  data  may  be  available  every  hour,  but  the  model  time  step  might  be  30  s. 
If  the  interpolation  parameter  is  set  to  1,  values  of  flow  rate  at  the  forcing 
boundaries  are  interpolated  at  each  model  time  step.  If  the  interpolation 
parameter  is  set  to  0,  no  interpolation  takes  place.  Following  the  first  and  second 
lines  of  the  QDRIVER  file  is  a  list  of  cell  numbers  that  are  forced  by  the  time 
series  data  given  in  the  forcing  data  file. 

If  more  than  one  forcing  data  file  is  applied  for  flow  rate,  information  is 
specified  exactly  as  previously  described  for  all  sets  of  forcing  data  and  placed  in 
the  QDRIVER  file  below  the  information  for  the  first  file. 

If  time  series  of  water-surface  elevation  is  specified  in  a  CMS-M2D  project, 
the  SMS  saves  the  QDRIVER  file  name  as  “qdriver_projectname.dat.” 

Files  containing  flow  rate  forcing  data  are  specified  to  have  two  values  on 
each  line.  The  first  value  is  the  time  stamp.  The  time  is  specified  in  hours  since 
the  beginning  of  the  simulation.  So,  at  t  =  0,  the  time  stamp  would  be  0.0  and  at 
t=  1  day,  the  time  stamp  would  be  24.0.  Time  stamps  must  start  at  0.0  and  end 
at  or  after  the  ending  time  of  the  simulation.  The  second  value  is  flow  rate  given 
in  m3/s.  This  flow  rate  is  specified  at  every  cell  designated  as  forced  by  the  input 
series  in  the  QDRIVER  file.  Thus,  if  three  cells  were  specified  as  flow  rate 
forcing  cells  and  the  value  of  the  flow  rate  was  9  m3/s,  then  each  of  the  three  cells 
would  have  9  m3/s  flowing  through  it.  The  flow  rate  is  not  distributed  among  the 
three  cells. 

The  SMS  contains  a  dialog  in  which  time  series  of  flow  rate  can  be 
prescribed  for  CMS-M2D.  If  this  dialog  is  accessed  to  create  the  time  series 
files,  they  will  be  saved  with  the  extension  “.q.” 

Wind  speed  and  direction 

Wind  speed  and  direction  are  given  in  the  user-specified  wind  file  listed  in 
the  model  control  file  (*.m2c).  The  wind- forcing  file  contains  three  values  on 
each  line.  The  first  value  is  the  time  stamp  in  hours  since  the  beginning  of  the 
simulation.  The  second  value  is  the  wind  speed  in  m/s  and  the  third  value  is 
direction  in  deg.  The  convention  for  the  input  wind  direction  is  0  deg  indicates 
wind  blowing  from  the  north,  and  90  deg  indicates  wind  blowing  from  the  east. 
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Wind  speed  must  be  positive.  Conversion  to  the  wind-direction  convention  given 
for  Equations  2  and  3  is  conducted  internally  within  CMS-M2D. 

The  SMS  contains  a  dialog  in  which  time  series  of  wind  speed  and  direction 
can  be  prescribed  for  CMS-M2D.  If  this  dialog  is  accessed  to  create  the  time 
series  file,  it  will  be  saved  with  the  extension  “.m2w.” 

Tidal  constituents 

The  tidal-constituent  forcing  file  contains  nine  lines.  The  first  line  is  a 
header  that  can  identify  the  source  of  the  tidal-constituent  information.  The 
header  line  is  ignored  by  CMS-M2D.  Each  of  the  remaining  lines  contain  the 
local  amplitude  (m)  and  phase  (deg)  of  the  water  level  for  a  specific  tidal 
constituent.  The  constituents  specified  on  lines  2  through  9  are  (in  order  of 
appearance):  M2,  N2,  S2,  K2,  Ki,  Oi,  M4,  and  M6.  If  specific  constituents  are  not 
to  be  specified  as  forcing,  then  their  amplitude  values  must  be  set  to  zero. 

Wave  stresses 

Wave  stresses  are  given  in  the  user-specified  radiation-stress  file  listed  in  the 
model  control  file.  The  radiation-stress  file  consists  of  sets  of  wave  stresses 
prescribed  at  specific  times.  The  first  line  in  the  file  contains  the  text  “TIME:” 
and  is  followed  by  the  time  in  hours  since  the  beginning  of  the  simulation. 

Lines  2  through  NCELLS  +  1  contain  three  values.  The  first  value  is  the  cell 
identification  number  and  the  second  and  third  values  are  the  x  and  y  components 
of  the  wave  stress,  respectively.  Wave  stresses  must  be  given  in  order  of 
ascending  cell  identification  numbers.  Sets  of  information  that  include  the  time 
step  and  wave  stresses  for  each  cell  are  included  in  the  file  for  each  time  step  for 
which  wave  stresses  are  available.  Because  CMS-M2D  will  conduct  its 
calculations  at  a  different  time  interval  than  the  wave  stress  time  interval,  the 
stresses  are  linearly  interpolated  within  CMS-M2D  over  time.  If  the  last  time 
stamp  in  the  wave  stress  file  specifies  a  time  before  the  end  of  the  CMS-M2D 
simulation,  CMS-M2D  will  apply  values  of  zero  for  the  radiation  stresses  after 
the  time  of  the  last  available  wave  information  (no  interpolation  to  zero  is 
conducted). 

If  the  Steering  Module  is  invoked  to  couple  CMS-M2D  with  STWAVE  (or 
WABED),  SMS  will  write  files  containing  wave  stresses  that  have  been  mapped 
from  those  calculated  by  the  wave  model.  SMS  gives  the  extension  “.rad”  to  the 
wave  stress  file.  The  same  file  extension  is  also  given  to  radiation  stress  files  for 
STWAVE.  CMS-M2D  files  can  be  distinguished  from  the  STWAVE  files  by  the 
prefix.  CMS-M2D  wave  stress  files  contain  the  text  “m2steer”  and  the 
STWAVE  files  contain  “swsteer.” 

Wave  properties  file 

The  wave  properties  file  contains  a  list  of  five  file  names  with  each  line 
containing  one  file  name.  The  files  must  be  listed  in  the  order  of  wave  height, 
wave  period,  wave  direction,  wave  breaking  index,  and  wave  dissipation.  Each 
of  the  files  listed  contains  fields  of  the  specified  wave  property.  If  SMS 
generates  the  wave  properties  file,  it  specifies  an  extension  of  “.mwv.” 
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Wave  height,  period,  direction,  breaking  index,  and  dissipation  are  provided 
as  time  series  of  fields  in  unique  files  (one  wave  property  per  file).  Each  file 
consists  of  sets  of  the  wave  property  prescribed  at  specific  times.  The  first  line  in 
the  file  contains  the  text  “TIME:”  and  is  followed  by  the  time  in  hours  since  the 
beginning  of  the  simulation.  Lines  2  through  NCELLS  +  1  contain  two  values. 
The  first  value  is  the  cell  identification  number,  and  the  second  value  is  the  wave 
property.  Values  of  wave  properties  must  be  given  in  order  of  ascending  cell 
identification  numbers.  Sets  of  information  that  include  the  time  step  and  wave 
properties  for  each  cell  are  included  in  the  file  for  each  time  step  that  wave 
properties  are  available.  Because  CMS-M2D  will  conduct  its  calculations  at  a 
different  time  interval  than  the  wave  property  time  interval,  the  property  is 
linearly  interpolated  within  CMS-M2D  over  time. 

Sediment  transport  and  morphology  change  specifications  file 

The  file  providing  the  sediment  transport  and  morphology  change 
specifications  contains  information  on  timing  control  for  transport  and 
morphology  change  calculations,  specification  of  the  transport  formulation  to 
apply,  general  parameter  settings,  and  parameter  settings  specific  to  the  selected 
transport  formulation.  Because  each  transport  formulation  requires  a  unique  set 
of  inputs,  the  format  for  this  file  varies  depending  on  the  chosen  formulation. 

This  file  is  required  to  have  the  name  “sedparams.dat.” 

If  the  Watanabe  sediment  transport  formulation  is  specified,  the 
sedparams.dat  file  will  contain  ten  lines,  each  having  a  single  value.  The  first 
line  will  have  an  integer  value  of  1,  which  is  an  index  that  informs  CMS-M2D  to 
apply  the  Watanabe  transport  formula.  The  second  and  third  lines  contain  the 
sediment  transport  rate  time  step  (sec)  and  the  morphology  change  time  step  (hr), 
respectively.  The  fourth,  fifth,  and  sixth  lines  contain  the  median  grain  size 
(mm),  sediment  density  (kg/m3),  and  the  water  density  (kg/m3),  respectively.  The 
seventh  line  contains  the  transport  rate  slope  coefficient  Ds  (unitless)  of 
Equations  112  and  113.  Line  8  contains  the  critical  threshold  for  sediment 
movement  transport.  Lines  9  and  10  contain  the  transport  rate  coefficient  A0  of 
Equations  112  and  113,  and  sediment  porosity  p ,  respectively. 

If  the  Lund-CIRP  sediment  transport  formulation  is  specified,  the 
sedparams.dat  file  will  contain  12  lines,  each  having  a  single  value.  The  first  line 
will  have  an  integer  value  of  2,  which  is  an  index  informing  CMS-M2D  that  the 
Lund-CIRP  transport  formula  is  to  be  applied.  The  second  and  third  lines  contain 
the  sediment  transport  rate  time  step  (sec)  and  the  morphology  change  time  step 
(hr),  respectively.  The  fourth,  fifth,  and  sixth  lines  contain  the  median  grain  size 
(mm),  sediment  density  (kg/m3),  and  water  density  (kg/m3),  respectively.  Line  7 
contains  the  water  temperature  (deg  C).  Line  8  contains  the  transport  rate  slope 
coefficient  Ds  (unitless)  of  Equations  112  and  113.  Line  9  contains  the  flag 
denoting  whether  or  not  ripples  are  included  in  the  calculations;  a  value  of  0 
indicates  that  ripples  are  not  included,  and  a  value  of  1  indicates  that  ripples  will 
be  included.  Line  10  contains  the  sediment  porosity.  Lines  1 1  and  12  contain 
the  scaling  factors  for  the  bed  load  and  suspended  load,  respectively. 

If  the  AD  equation  is  selected  as  the  sediment  transport  formulation,  the 
sedparams.dat  file  will  contain  13  lines,  each  having  a  single  value.  The  first  line 
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will  have  an  integer  value  of  3,  which  is  an  index  informing  CMS-M2D  that  the 
AD  equation  is  to  be  applied  to  compute  the  sediment  transport  rate.  The  second 
and  third  lines  contain  the  sediment  transport  rate  time  step  (sec)  (time  step  at 
which  the  AD  equation  is  solved)  and  the  morphology  change  time  step  (hr), 
respectively.  Lines  4  through  7  contain  the  median  particle  diameter  (mm), 
sediment  density  (kg/m3),  water  density  (kg/m3),  and  water  temperature  (deg  C), 
respectively.  Line  8  contains  the  slope  coefficient  for  Equations  115  and  116. 
Line  9  contains  the  flag  denoting  whether  or  not  ripples  are  included  in  the 
calculations;  a  value  of  0  indicates  that  ripples  are  not  included,  and  a  value  of  1 
indicates  that  ripples  will  be  included.  Line  10  contains  the  sediment  porosity. 
Line  1 1  contains  an  index  that  specifies  the  type  of  suspended  concentration 
profile  in  which  a  value  of  1  denotes  an  exponential  profile  with  the  depth- 
averaged  mixing  coefficient  of  Van  Rijn,  a  value  of  2  denotes  a  Van  Rijn  profile 
with  Van  Rijn's  mixing  coefficient,  and  3  denotes  an  exponential  profile  from  the 
Lund-CIRP  formulation.  Lines  12  and  13  contain  the  scaling  factors  for  the  bed 
load  and  suspended  load,  respectively. 

Non-erodible  cell  specifications  file 

The  non-erodible  cell  specifications  file  contains  the  number  of  non-erodible 
cells  in  the  computational  grid,  followed  by  a  listing  of  the  hard-bottom  cell 
identification  number  and  depth  of  hard  substrate.  One  cell  identification  number 
and  its  corresponding  hard  substrate  depth  are  listed  on  each  line.  If  hard-bottom 
cells  do  not  exist  on  the  grid,  the  file  will  contain  a  value  of  zero  for  the  number 
of  non-erodible  cells.  This  file  is  required  to  have  the  name  “noerode.dat.” 

Selected  cell  output  specification  file 

User-specified  observation  cells  can  be  selected  for  time  series  output  of 
variables  or  terms  in  the  governing  equations.  A  listing  of  these  cells  is  provided 
in  a  cell  output  specification  file.  The  file  contains  a  list  of  cell  identification 
numbers  with  one  number  per  line.  If  observation  cells  are  selected  within  the 
SMS  and  saved  as  part  of  a  CMS-M2D  project,  the  SMS  gives  the  cell  listing  file 
the  extension  of  “.ts.” 

Global  output  time  specification  files 

Global  water-surface  elevation,  velocity,  depth,  and  sediment  transport  rates 
are  written  to  files  at  times  specified  in  the  global  output  time-specification  files. 
These  files  consist  of  a  list  of  times,  in  hours  since  the  beginning  of  the 
simulation,  at  which  global  output  is  to  be  written.  Each  line  in  these  files 
consists  of  one  time  value.  Separate  global  output  time-specification  files  are 
required  for  water-surface  elevation  and  velocity,  providing  the  option  to  save 
only  one  global  file. 

Times  listed  in  the  global  output  time-specification  files  can  be  at  constant  or 
varying  time  intervals.  Requirements  for  the  times  listed  in  the  file  are  that  they 
are  sequential,  start  at  values  of  zero  or  greater,  and  values  are  not  repeated. 

If  global  output  times  are  specified  within  the  SMS,  a  series  of  equal- 
increment  output  times  can  be  generated.  In  addition,  individual  times  can  also 
be  specified.  If  scalar  and  vector  global  files  are  to  be  written,  the  output  times 
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from  one  of  these  variables  can  be  written  to  the  other  so  that  the  global  output 
will  take  place  at  the  same  times.  SMS  writes  the  global  output  time- 
specification  files  with  an  extension  of  “.m2t.” 

Output  Files 

Two  types  of  output  files  can  be  specified  for  CMS-M2D.  These  file  types 
are  time  series  of  a  variable  at  station  locations  and  global  variable  files. 
Descriptions  of  these  file  types  are  given  here.  For  both  types  of  output  files, 
each  variable  is  reported  from  its  computational  location  in  the  model.  Thus, 
water-surface  elevation  is  reported  from  the  cell  center,  the  x-component  of 
velocity  is  reported  from  the  left  cell  face  center,  and  the  y-component  of 
velocity  is  reported  from  the  bottom  cell  face  center. 

Time  series  at  station  locations 

Time  series  output  files  for  specific  station  locations  contain  a  header  line 
followed  by  the  calculated  time  series  values.  The  header  specifies  the  cell 
numbers  (where  output  is  taken)  above  columns  of  output.  Cell  numbers  in  the 
header  are  written  as  “C#”  where  #  denotes  the  cell  number.  The  “C”  is  placed 
in  the  header  to  distinguish  the  cell  number  from  data  in  plotting  packages 
(software  will  read  the  information  in  as  a  character  string).  Lines  following  the 
header  contain  a  time  stamp  (fractional  days)  and  values  of  the  variable. 

Water-surface  elevation  and  the  two  components  of  velocity  are  each  written 
to  separate  files  for  a  total  of  three  possible  station  output  files.  The  user  can 
specify  any  combination  of  time  series  station  output  files  to  be  written. 

Global  output  files 

Global  files  can  be  created  for  water-surface  elevation,  velocity,  sediment 
transport  rate,  and  depth.  File  formats  consist  of  sets  of  global  variable  values 
output  at  times  specified  by  the  user.  Each  set  of  information  in  the  file  contains 
a  line  with  the  time  stamp,  followed  by  lines  containing  the  x,y  position  of  each 
cell  followed  by  the  value  of  the  variable(s)  being  output,  i.e.,  water-surface 
elevation,  depth,  velocity  components,  or  transport  rate  components.  If  transport 
rates  are  output,  the  instantaneous  total  load  values  are  saved  to  the  file  specified 
by  the  user,  and  the  averaged  transport  rates  are  saved  to  a  file  having  “AVG” 
appended  to  the  file  name  prefix.  If  the  transport  formulation  applied  by  CMS- 
M2D  computes  suspended  load  and  bed  load  separately,  then  two  additional 
transport  rate  files  will  be  saved,  one  containing  the  suspended  load  transport  rate 
and  the  other  containing  the  bed  load  transport  rate.  These  two  files  have  the 
letters  “BED”  and  “SUS”  appended  to  the  file  name  prefix  to  indicate  whether 
they  contain  the  bed  load  or  suspended  load,  respectively.  Global  information  is 
saved  for  each  cell  in  the  grid  and  written  in  ascending  order  of  cell  identification 
number.  File  extensions  of  .m2s  are  assigned  to  scalar  fields  and  .m2v  to  vector 
fields. 

Units  for  time  series  and  global  files  are  standard  metric.  Water-surface 
elevation  and  depth  are  given  in  m,  velocity  is  given  in  m/s,  and  sediment 
transport  rates  are  given  in  m3/s/m.  Time  stamps  are  given  in  hours  since  the 
beginning  of  the  simulation. 
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In  this  chapter,  applications  are  described  for  an  idealized  channel  and  two 
coastal  inlets  in  the  United  States  to  demonstrate  the  performance  and 
capabilities  of  CMS-M2D.  The  idealized  channel  example  demonstrates 
calculation  of  channel  infilling.  The  example  for  Ocean  City  Inlet,  MD, 
demonstrates  combined  circulation,  wave,  and  sediment  transport  modeling  for  a 
storm  condition.  The  example  for  Sebastian  Inlet,  FL,  demonstrates  functioning 
of  the  hard-bottom  capability  under  tide  and  wave  forcing. 

Channel  Infilling  Example 

Simulations  of  ID  channel  infilling  were  conducted  to  compare  results  of  the 
total  load  (TL)  sediment  transport  formulation  and  the  AD  formulation.  The 
channel  infilling  process  is  a  clear  example  demonstrating  effectiveness  of  the 
AD  formulation.  To  simulate  channel  infilling,  representation  of  advection  and 
diffusion  of  suspended  sediment  load  is  necessary  because  suspended  sand 
having  high  concentration  outside  the  channel  can  be  transported  by  the  current 
and  settle  to  areas  of  weak  current,  such  as  the  bottom  of  a  channel  or  bay.  Irie 
et  al.  (1985)  reported  that  morphology  change  of  this  kind  is  difficult  to 
reproduce  by  total  load  models  that  calculate  the  sediment  transport  rate 
depending  only  on  the  local  shear  stress  and  do  not  include  the  AD  process. 

A  simple  channel  infilling  test  was  conducted  under  the  situation  shown  in 
Figure  33.  Water  depth  outside  the  channel  is  5  m  and  that  inside  the  channel  is 
10  m.  In  this  situation,  a  current  of  0.9  m/s  (directed  from  left  to  right  in  the 
figure)  was  generated  by  specifying  a  water-surface  elevation  of  0.05  m  at  the 
left  boundary  cells  and  that  of  -0.05  m  at  the  right  boundary  cells.  Sediment 
grain  size  was  specified  to  be  0.2  mm,  and  sediment  density  was  set  to 
2,650  kg/m3.  Figure  34  shows  the  spatial  distributions  of  each  variable  calculated 
by  the  AD  formulation  with  the  Lund-CIRP  formula,  together  with  the  depth 
profile.  From  top  to  bottom,  water  elevation,  current  velocity,  depth-averaged 
concentration,  and  initial  bed  profile  are  plotted.  Because  of  the  AD  process, 
sediment  concentration  is  asymmetrically  distributed  about  the  center  of  the 
channel,  even  though  water  elevation  and  current  velocity  are  almost  symmetric. 


124 


Chapter  10  Example  Applications 


Figure  33.  Configuration  for  channel  infilling  tests 


Figure  34.  Surface  elevation,  current  velocity,  and  concentration  calculated  by 
AD  formulation  with  Lund-CIRP  formula 
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Results  of  the  channel  infilling  simulation  are  shown  in  Figure  35  (AD)  and 
Figure  36  (TL).  The  AD  formulation  reproduces  general  channel  deformation 
processes  such  as  bank  encroachment  and  infilling.  On  the  other  hand,  the  TL- 
model  is  inadequate,  being  capable  of  producing  only  channel  bank 
encroachment  and  channel  migration,  but  not  channel  infilling.  Bank 
encroachment  arises  primarily  from  bed  load  transport  and  channel  infilling 
primarily  from  suspended  load  transport.  Thus,  accurate  calculation  of 
suspended  load  as  through  an  AD  formulation  is  essential  for  simulating  the 
channel  infilling  process. 


Figure  35.  Channel  profile  change  by  AD  formulation,  grain  size  =  0.2  mm 


Figure  36.  Channel  profile  change  by  TL  formulation,  grain  size  =  0.2  mm 
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Figure  37  compares  the  channel  shapes  after  10  days  of  simulation  time. 
Because  the  both  simulations  apply  the  same  transport  rate  formula  (Lund-CIRP 
formula),  the  total  amount  of  sediment  transported  into  the  channel  is  almost 
identical,  but  the  resultant  channel  shape  is  different.  The  reason  for  the 
difference  is  that  the  AD  formulation  calculates  the  advection  and  diffusion  of 
suspended  sediment,  which  the  TL  formulation  neglects. 


Figure  37.  Channel  shape  comparison  between  AD  and  TL  formulations,  grain 
size  =  0.2  mm,  10-day  simulation  time 


Figures  38  and  39  show  the  results  of  channel  deformation  for  sediment  grain 
size  of  0.4  mm.  In  this  situation,  bed  load  transport  becomes  dominant  as 
compared  to  the  case  of  0.2-mm  sand  grains,  and  the  calculated  channel  shape  is 
almost  identical  between  AD  and  TL  formulations. 

In  summary,  if  suspended  load  is  dominant,  the  AD  formulation  can  more 
accurately  describe  channel  infilling,  whereas  if  bed  load  is  dominant,  a  TL 
formulation  might  be  more  accurate  and  is  more  efficient  in  terms  of  the 
allowable  morphology  time  step.  Also,  from  the  point  of  view  of  computational 
costs,  a  TL  formulation  is  more  efficient  than  the  AD.  In  the  CMS-M2D  system, 
therefore,  users  can  select  a  sediment  transport  formulation  depending  on  the 
situation.  In  particular,  in  preliminary  runs,  a  TL  formula  might  be  selected,  with 
the  final  production  runs  switching  to  an  AD  formulation. 
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Figure  39.  Channel  profile  change  by  TL  formulation,  grain  size  =  0.4  mm 


Ocean  City  Inlet,  MD 

Ocean  City  Inlet  is  a  dual-jettied  Federal  inlet  located  on  the  coast  of  the 
Delmarva  Peninsula.  In  August  1933,  the  inlet  was  opened  as  a  breach  in 
Fenwick  (barrier)  Island,  and  jetties  were  soon  constructed  to  stabilize  the 
entrance.  Dean  and  Perlin  (1977)  discuss  coastal  and  inlet  processes  at  the  site. 
For  the  present  example,  a  December  1992  northeaster  was  selected  to  simulate 
hydrodynamic  and  sediment  transport  processes  during  a  severe  storm. 

The  example  of  Ocean  City  Inlet  is  provided  to  demonstrate  the  following 
capabilities  of  the  CMS: 

Model  Steering:  coupling  between  CMS-M2D  and  STWAVE 

CMS-M2D  forcing:  extraction  of  boundary  conditions  from  a  regional 
model 
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Sediment  transport:  application  of  the  AD  transport  equation. 

CMS-M2D  and  STWAVE  grids  were  developed  for  the  Ocean  City  Inlet 
system  so  that  interaction  between  tidal,  wave,  and  morphology  change  processes 
could  be  calculated.  The  CMS-M2D  computational  domain  with  bathymetry  and 
grid  is  shown  in  Figure  40.  The  corresponding  STWAVE  domain  (Figure  41)  is 
slightly  larger  than  the  CMS-M2D  domain  in  the  Atlantic  Ocean,  but  is  truncated 
in  the  bay.  The  STWAVE  grid  configuration  in  the  Atlantic  Ocean  portion  area 
is  slightly  larger  than  the  CMS-M2D  grid  to  avoid  extrapolation  of  wave 
properties  and  radiation  stresses  over  and  near  the  CMS-M2D  boundary.  Within 
the  bay  area,  the  CMS-M2D  grid  is  larger  than  the  STWAVE  grid  because 
significant  wave  energy  is  not  expected  to  propagate  from  the  bay  side  of  the 
inlet  toward  the  north  or  south. 


Figure  40.  Bathymetry  and  CMS-M2D  computational  grid  for  Ocean  City  Inlet 


Figure  41 .  Bathymetry  and  STWAVE  computational  grid  for  Ocean  City  Inlet 
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The  CMS-M2D  grid  contains  14,886  ocean  cells  that  have  dimensions 
ranging  from  26.5  to  127.8  m.  Greatest  detail  is  specified  in  the  inlet  and 
nearshore  area,  including  the  ebb  shoal.  The  STWAVE  grid  contains  81,102 
computational  cells  having  dimensions  of  44.9  m  on  each  side. 

For  simulation  of  the  December  1992  northeaster,  a  regional  ADCIRC 
solution  was  available  that  could  be  applied  as  CMS-M2D  boundary  forcing. 
Simulation  of  the  storm  started  on  8  December  1992  and  ran  for  8  days.  The 
ADCIRC  domain  (Figure  42)  is  large  enough  to  represent  the  storm  surge 
propagation.  Therefore,  by  applying  the  ADCIRC  solution  to  force  CMS-M2D 
at  its  ocean  and  bay  boundaries,  temporal  and  spatial  variations  in  the  sea  surface 
owing  to  the  combined  wind,  atmospheric  pressure,  and  tidal  forcing  were 
preserved.  An  example  of  the  spatial  distribution  in  water-surface  elevation  is 
shown  in  Figure  43,  during  the  peak  surge  along  the  Maryland  coast. 


Figure  42.  Regional  ADCIRC  mesh  and  bathymetry  for  Maryland  coast 
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Figure  43.  Calculated  peak  water-surface  elevation  along  Maryland  coast  for 
December  1992  storm 


The  8-day  CMS-M2D  simulation  was  forced  with  water-surface  elevation 
values  along  the  ocean  boundary  and  bay  boundaries  extracted  from  the  regional 
ADCIRC  solution  for  the  December  1992  storm.  A  ramp  duration  of  0.5  day  was 
specified.  Wave  properties  at  1-hr  intervals  were  obtained  from  measurements 
and  applied  as  input  to  STWAVE.  The  steering  interval  was  specified  to  be  1  hr. 
Sediment  transport  was  computed  by  the  AD  equation  with  the  Lund-CIRP 
profile  option.  The  advection-diffusion  equation  was  solved  every  10  s  and  the 
morphologic  time  step  was  0.25  hr. 

An  example  of  the  current  field  during  strong  storm  forcing  is  shown  in 
Figure  44,  when  the  surge  level  was  1.06  m,  offshore  wave  conditions  were 
height  of  4.8  m,  period  of  14  s,  and  direction  of  62  deg  south  of  east.  The 
velocity  field  shows  a  strong  current  generated  along  the  outer  edge  of  the  ebb 
shoal  from  wave  shoaling  and  breaking.  A  well-developed  longshore  current  is 
directed  toward  the  north. 
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Figure  44.  Calculated  velocity  field  at  Ocean  City  Inlet  during  4.8  m  wave 
condition,  December  1992  storm 


A  time  series  of  current  fields  at  10-hr  intervals  is  shown  in  Figure  45.  The 
starting  image  at  hour  60  corresponds  to  10  December  1992  at  noon.  In  this 
series  of  plots,  changes  in  strength,  pattern,  and  direction  of  the  currents  are 
responses  to  the  temporal  and  spatial  properties  of  the  waves  and  to  a  lesser 
extent,  the  storm  surge.  Initially,  waves  propagate  from  the  south  east  and  drive 
a  north-directed  longshore  current  (through  hour  90).  As  the  wave  direction 
rotates  over  the  duration  of  the  storm,  the  north-directed  longshore  current 
becomes  weaker  (hours  90-110)  then  turns  toward  the  south  for  the  remainder  of 
the  storm.  Over  the  duration  of  the  storm,  waves  reaching  the  ebb  shoal  drive 
currents  toward  the  north  on  the  northern  outer  portion  of  the  shoal  and  toward 
the  south  and  shoreward  on  the  southern  outer  portion  of  the  shoal. 
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Figure  45.  Calculated  velocity  fields  at  1 0-hr  intervals  at  Ocean  City  Inlet, 
December  1992  storm 
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Figure  45  (continued).  Calculated  velocity  fields  at  10-hr  intervals  at  Ocean  City 
Inlet,  December  1992  storm 

Morphology  change  calculated  for  the  storm  is  evident  in  the  inlet  entrance. 
Figure  46  shows  the  initial  bathymetry  at  the  start  of  the  simulation  (hour  0), 
bathymetry  after  the  longshore  current  has  been  directed  northward  (hour  100), 
and  bathymetry  at  the  end  of  the  simulation  (hour  180)  during  which  the 
longshore  current  was  directed  toward  the  south  for  about  the  last  80  hr.  Initially, 
the  scour  hole  located  at  the  inlet  entrance  is  deepest.  After  100  hr  of  simulation, 
some  infilling  of  the  scour  hole  had  taken  place  with  material  transported  from 
the  south.  After  180  hr  of  simulation,  the  scour  hole  had  continued  to  fill  with 
sediment  transported  from  the  north,  which  also  steepened  the  northern  flank  of 
the  scour  hole  (contours  become  slightly  closer  together). 
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Figure  46.  Calculated  depth  at  Ocean  City  Inlet,  December  1992  storm 
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Depth  change  at  the  inlet  and  ebb  shoal  after  100  and  180  hr  of  simulation  is 
shown  in  Figure  47.  Red  and  yellow  denote  accretion,  and  blue  denotes  erosion. 
The  most  significant  changes  in  morphology  are  deposition  at  the  inlet  entrance, 
scour  off  of  the  tip  of  the  north  jetty,  and  alternating  bands  of  accretion  and 
erosion  around  the  outer  areas  of  the  ebb  shoal. 


Figure  47.  Calculated  depth  change  at  Ocean  City  Inlet,  December  1992  storm 
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Sebastian  Inlet,  FL 

Sebastian  Inlet  is  on  the  south-central  east  coast  of  Florida  and  connects  the 
Atlantic  Ocean  to  the  Indian  River  Lagoon.  In  1927,  deepening  of  the  inlet  that 
began  in  1924  was  accomplished  by  blasting  of  limestone  rock.  At  present,  most 
of  the  inlet  throat  is  comprised  of  hard  substrate.  In  addition,  rock  outcrops  are 
present  in  the  nearshore  at  and  directly  south  of  the  inlet.  Figure  48  is  an  image 
showing  the  inlet  and  extent  of  hard  bottom.  Because  of  the  significant  rock 
exposure,  Sebastian  Inlet  was  selected  as  a  location  to  demonstrate  the  CMS 
featuring  the  hard-bottom  capability.  Bathymetry  data,  information  on  hard- 
bottom  coverage,  and  forcing  data  (water- surface  elevation  and  wave  properties) 
were  provided  by  Dr.  Gary  A.  Zarillo,  Florida  Institute  of  Technology. 


Denotes  hard  bottom 


Sebastian  Inlet 


Atlantic  Ocean 


Figure  48.  Aerial  photograph  of  Sebastian  Inlet  with  hard  bottom  shown  (image 
courtesy  of  Dr.  Gary  A.  Zarillo,  Florida  Institute  of  Technology) 


The  example  of  Sebastian  Inlet  is  provided  to  demonstrate  the  following 
capabilities  of  the  CMS: 

a.  Model  Steering:  coupling  between  CMS-M2D  and  STWAVE 

b.  CMS-M2D  forcing:  application  of  water-level  measurements  at 
boundaries 

c.  Sediment  transport:  application  of  Lund-CIRP  total  load  formulation 

d.  Morphologic  constraints:  specification  of  hard-bottom  cells. 
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CMS-M2D  and  STWAVE  grids  were  developed  for  Sebastian  Inlet  so  that 
interaction  between  tidal,  wave,  and  morphology  change  processes  could  be 
calculated.  The  CMS-M2D  computational  domain  with  bathymetry  and  grid  are 
shown  in  Figure  49,  and  the  corresponding  STWAVE  bathymetry  and  domain 
are  shown  in  Figure  50.  The  STWAVE  domain  in  the  Atlantic  Ocean  portion  of 
the  grid  is  slightly  larger  than  the  CMS-M2D  grid  to  avoid  extrapolation  of  wave 
properties  and  radiation  stresses  over  and  near  the  CMS-M2D  boundary.  Within 
the  Indian  River  Lagoon,  the  CMS-M2D  grid  is  larger  than  the  STWAVE  grid 
because  significant  wave  energy  is  not  expected  to  propagate  from  the  bay  side 
of  the  inlet  toward  the  north  or  south.  In  addition,  gauge  data  for  water-surface 
elevation  forcing  was  available  at  the  north  and  south  lagoon  extents. 


Figure  49.  Bathymetry  and  CMS-M2D  computational  grid  for  Sebastian  Inlet 
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Figure  50.  Bathymetry  and  STWAVE  computational  grid  for  Sebastian  Inlet 


The  CMS-M2D  grid  contains  18,762  ocean  cells,  which  have  dimensions 
ranging  from  9.6  to  99.9  m.  Greatest  detail  is  specified  in  the  inlet  and  nearshore 
(Figure  51).  Hard-bottom  cells  (Figure  52)  were  specified  by  overlaying  the 
aerial  photograph  denoting  hard-bottom  areas  (Figure  48)  onto  the  CMS-M2D 
computational  grid  and  assigning  cells  that  had  at  least  50  percent  coverage  of 
hard  bottom  as  non-erodible.  Depth  of  non-erodible  substrate  for  the  hard- 
bottom  cells  was  specified  to  be  the  ambient  depth.  The  STWAVE  grid  contains 
24,095  computational  cells  having  dimensions  of  20  m  on  each  side. 


Figure  51 .  Detail  of  CMS-M2D  grid  resolution  and  bathymetry  at  Sebastian  Inlet 


Chapter  10  Example  Applications 


139 


A  15-day  simulation  was  conducted  with  water-surface  elevation  forcing 
along  the  ocean  boundary  and  along  the  northern  and  southern  boundaries 
located  in  the  Indian  River  Lagoon.  Time  series  for  these  three  boundaries  were 
obtained  from  hourly  measurements  taken  from  1  January  to  15  January  1997. 
Daily  wave  input  to  STWAVE  was  also  obtained  from  measurements  for  the 
same  time  period.  The  steering  interval  was  specified  to  be  6  hr.  Sediment 
transport  options  included  application  of  the  Lund-CIRP  total  load  formula  with 
a  sediment  transport  time  step  of  120  s  and  a  morphologic  time  step  of  0.4  hr. 
Suspended  load  and  bed  load  scaling  factors  were  each  specified  as  0.1. 


Figure  52.  Hard-bottom  cells  specified  for  Sebastian  Inlet  (denoted  by  triangles) 


Representative  ebb  and  flood  currents  calculated  for  Sebastian  Inlet  are 
shown  in  Figure  53.  During  ebb  and  flood,  the  strongest  currents  are  in  the 
center  of  the  inlet  throat  and  overlying  hard  substrate.  Calculated  change  in 
depth  over  the  simulation  interval  is  shown  in  Figure  54,  together  with  the 
location  of  hard-bottom  cells  denoted  by  triangles.  In  the  inlet  throat,  deposition 
takes  place  along  the  southern  extent  of  the  hard-bottom  cells  and  erosion  takes 
place  between  this  area  of  deposition  and  the  southern  inlet  wall.  Erosion  of 
hard-bottom  cells  below  the  prescribed  depth  of  the  hard  substrate  does  not  take 
place.  Material  on  the  outer  ebb  shoal  has  migrated  shoreward  in  response  to 
combined  wave-  and  current-driven  transport. 
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Figure  53.  Representative  calculated  ebb  and  flood  currents  at  Sebastian 
Inlet,  top  and  bottom  panels,  respectively 
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Appendix  A 

Example  Input  and  Output 
Files 


This  appendix  contains  example  input  and  output  files  for  CMS-M2D. 
Sample  files  were  selected  from  various  applications  to  illustrate  file  formats. 
Input  files  are  shown  first,  followed  by  output  files. 

An  example  grid  file  is  shown  in  Figure  A1  for  a  19-km-long  frictionless 
channel.  The  channel  is  19  cells  long,  1  cell  wide,  and  1  m  deep.  Cells  have 
dimensions  of  1,000  m  on  each  side.  Cell-center  coordinates,  x-dist  andy-dist, 
are  given  in  meters  from  the  grid  origin. 


Cell  no. 

NC 

EC 

SC 

wc 

NB 

EB 

SB 

WB 

I  AC  TV 

DX 

DY 

H 

N 

ROW 

COL 

LAT 

X-DIST 

Y-DIST 

1 

0 

2 

0 

0 

4 

0 

4 

4 

1 

1000. 

1000. 

1.000 

.00 

1 

1 

.00 

500. 

500. 

2 

0 

3 

0 

1 

4 

0 

4 

0 

1 

1000. 

1000. 

1.000 

.00 

1 

2 

.00 

1500. 

500. 

3 

0 

4 

0 

2 

4 

0 

4 

0 

1 

1000. 

1000. 

1.000 

.00 

1 

3 

.00 

2500. 

500. 

4 

0 

5 

0 

3 

4 

0 

4 

0 

1 

1000. 

1000. 

1.000 

.00 

1 

4 

.00 

3500. 

500. 

5 

0 

6 

0 

4 

4 

0 

4 

0 

1 

1000. 

1000. 

1.000 

.00 

1 

5 

.  00 

4500. 

500. 

6 

0 

7 

0 

5 

4 

0 

4 

0 

1 

1000. 

1000. 

1.000 

.00 

1 

6 

.00 

5500. 

500. 

7 

0 

8 

0 

6 

4 

0 

4 

0 

1 

1000. 

1000. 

1.000 

.00 

1 

7 

.00 

6500. 

500. 

8 

0 

9 

0 

7 

4 

0 

4 

0 

1 

1000. 

1000. 

1.000 

.00 

1 

8 

.00 

7500. 

500. 

9 

0 

10 

0 

8 

4 

0 

4 

0 

1 

1000. 

1000. 

1.000 

.00 

1 

9 

.  00 

8500. 

500. 

10 

0 

11 

0 

9 

4 

0 

4 

0 

1 

1000. 

1000. 

1.000 

.00 

1 

10 

.00 

9500. 

500. 

11 

0 

12 

0 

10 

4 

0 

4 

0 

1 

1000. 

1000. 

1.000 

.00 

1 

11 

.00 

10500. 

500. 

12 

0 

13 

0 

11 

4 

0 

4 

0 

1 

1000. 

1000. 

1.000 

.00 

1 

12 

.00 

11500. 

500. 

13 

0 

14 

0 

12 

4 

0 

4 

0 

1 

1000. 

1000. 

1.000 

.00 

1 

13 

.00 

12500. 

500. 

14 

0 

15 

0 

13 

4 

0 

4 

0 

1 

1000. 

1000. 

1.000 

.00 

1 

14 

.00 

13500. 

500. 

15 

0 

16 

0 

14 

4 

0 

4 

0 

1 

1000. 

1000. 

1.000 

.00 

1 

15 

.00 

14500. 

500. 

16 

0 

17 

0 

15 

4 

0 

4 

0 

1 

1000. 

1000. 

1.000 

.00 

1 

16 

.  00 

15500. 

500. 

17 

0 

18 

0 

16 

4 

0 

4 

0 

1 

1000. 

1000. 

1.000 

.00 

1 

17 

.00 

16500. 

500. 

18 

0 

19 

0 

17 

4 

0 

4 

0 

1 

1000. 

1000. 

1.000 

.00 

1 

18 

.00 

17500. 

500. 

19 

0 

0 

0 

18 

4 

4 

4 

0 

1 

1000. 

1000. 

1.000 

.00 

1 

19 

.00 

18500. 

500. 

Figure  A1 .  Example  grid  file  for  channel 


An  example  model  control  (*.m2c)  file  is  shown  in  Figure  A2.  The 
simulation  is  set  up  to  calculate  hydrodynamics  and  sediment  transport  in  a  flume 
having  cell  spacing  of  0.5  m.  In  this  example,  a  24-hr  simulation  is  specified 
with  a  0.05-s  time  step.  The  automatic  recurring  hot-start  capability  is  invoked 
with  hot-start  files  written  every  6  hr.  Advective  and  mixing  terms  in  the 
momentum  equations  are  included  in  the  computations.  Wetting  and  drying  is 
allowed  to  occur,  and  cells  will  dry  at  a  water  depth  of  0.03  m.  Global  velocity 

and  transport  rates  are  written  at  times  specified  in  the  “Flume _ m2d_V.m2f  ’ 

and  global  water-surface  elevation  and  depth  values  are  to  be  written  at  times 
specified  in  the  “Flume _ m2d_E.m2f  ’  file. 
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Version  3.02 

10.0 

ANEMOMETER  HEIGHT  (M) 

ASCII 

OUTPUT  FILE  TYPE  (ASCII/BINARY/BOTH) 

0.00 

ANGLE  BETWEEN  TRUE  NORTH  AND  Y-AXIS  OF  GRID 

0.0000 

GRID  ORIGIN  (M),  (X-COORDINATE) 

0.0000 

GRID  ORIGIN  (M),  (Y-COORDINATE) 

0.0500 

DELTA  T  (SEC) 

6.000 

AUTOMATIC  RECURRING  HOT  START  INTERVAL  (HR) 

1 

INCLUDE  ADVECTIVE  TERMS:  0  =  NO,  1  =  YES 

1 

INCLUDE  MIXING  TERMS:  0  =  NO,  1  =  YES 

0 

INCLUDE  WALL  FRICTION:  0  =  NO,  1  =  YES 

0.03 

DEPTH  (M)  TO  BEGIN  DRYING  CELLS 

1 

CALCULATE  SEDIMENT  TRANSPORT:  0  =  NO,  1  =  YES 

01001 

STARTING  JULIAN  DAY  (YYDDD  OR  DDD) 

0 

START  TIME  (HOUR) 

24.000 

REALIZATION  TIME  (HOUR) 

0.100 

RAMP  DURATION  (DAY) 

0.000 

STEERING  MODULE  (MULTIPLE  SIMULATION)  ELAPSED  TIME  (HOUR) 

0.000 

TIME  TO  WRITE  OUTPUT  FOR  HOT  START  (HR) 

Flume.  m2g 

GRID  INPUT  FILE  NAME 

default 

INITIAL  CONDITIONS  FILE  NAME 

none 

TIDAL  CONSTITUENT  INPUT  FILE 

none 

WIND  INPUT  FILE 

0 

INCLUDE  RADIATION  STRESSES:  0  =  NO,  1  =  YES 

none 

WAVE  DATA  FILE 

none 

RADIATION  STRESS  INPUT  FILE  (WRITTEN  BY  STWAVE/WABED) 

none 

HOT  START  OUTPUT  FILE 

Flume _ m2d_V.m2t 

TIME  SPECIFICATION  FILE  FOR  VECTOR  PLOT  OUTPUT 

Flume _ m2d_E.m2t 

TIME  SPECIFICATION  FILE  FOR  GLOBAL  ELEVATION  OUTPUT 

none 

TIME-SERIES  INPUT  FILE 

none 

FLOW  RATE  TIME-SERIES  INPUT  FILE 

0 

TIME  BETWEEN  OUTPUT  FILE  WRITES  (SEC)  FOR  TIME-SERIES  FILE 

0 

TIME  BETWEEN  OUTPUT  FILE  WRITES  (SEC)  FOR  FLOW  RATE  FILE 

none 

TIME-SERIES  OUTPUT  FILE  FOR  U 

none 

TIME-SERIES  OUTPUT  FILE  FOR  V 

none 

TIME-SERIES  OUTPUT  FILE  FOR  ETA 

none 

FLOW  RATE  OUTPUT  FILE  FOR  X-DIRECTION 

none 

FLOW  RATE  OUTPUT  FILE  FOR  Y-DIRECTION 

vel 

PREFIX  FOR  VECTOR  OUTPUT  FILE  NAME 

El 

PREFIX  FOR  GLOBAL  ELEVATION  OUTPUT  FILE  NAME 

bot 

PREFIX  FOR  GLOBAL  BOTTOM  CHANGE  FILE  NAME 

trans 

PREFIX  FOR  GLOBAL  SEDIMENT  TRANSPORT  RATE  FILE  NAME 

hdriver_Flume _ n2d.dat 

HDRIVER.DAT  FILE 

none 

QDRIVER.DAT  FILE 

none 

MHDRIVER.DAT  FILE 

none 

MVDRIVER.DAT  FILE 

Figure  A2.  Example  model  control  file 


An  example  time-specification  file  for  either  global  vector  or  scalar  output  is 
shown  in  Figure  A3.  The  file  lists  specific  times,  in  hours,  with  one  time  value 
per  line.  CMS-M2D  will  write  solutions  to  the  global  output  file  at  these  times. 


0.  00 

1.  00 

2.  00 

3.  00 

4.  00 

5.  00 

6.  00 

7.  00 

8.  00 

9.  00 

10.  00 

11.  00 


Figure  A3.  Example  time-specification  file  for  global  output 
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An  example  hdriver.dat  file  is  shown  in  Figure  A4.  Two  water-level  forcing 
files  will  be  read  and  the  total  number  of  water-surface  elevation  forcing  cells  is 
10.  Files  “Gaugel.wl”  and  “Gauge2.wl”  contain  water-level  forcing  data.  Data 
from  Gaugel.wl  is  prescribed  at  four  cells  (cell  numbers  1,  2,  3,  and  4)  and  the 
water  level  is  to  be  interpolated  between  model  time  steps.  Data  from  Gauge2.wl 
is  applied  at  six  cells  (cell  numbers  64,  65,  66,  67,  68,  and  69)  with  interpolation 
between  model  time  steps.  Qdriver.dat  files  have  identical  format,  so  a  separate 
example  is  not  given. 


2  10 

Gaugel.  wl 
4  1 
1 
2 

3 

4 

Gauge2.  wl 
6  1 

64 

65 

66 

67 

68 
69 


Figure  A4.  Example  hdriver.dat  file 

An  example  of  a  time  series  water-level  forcing  file  is  shown  in  Figure  A5. 
Files  “Gaugel.wl”  and  “Gauge2.wl”  shown  in  Figure  A4  are  in  this  format.  The 
first  column  contains  time  stamps  (hours)  and  the  second  column  provides  water 
level  (m).  Flow  rate  forcing  files  have  the  same  format  as  shown  in  Figure  A5. 


0 

-0.0455 

0.9912 

0.0319 

1.992 

0.1373 

2.9928 

0.2738 

3.9912 

0.3948 

4.992 

0.4652 

5.9928 

0.4515 

6.9912 

0.3759 

7 .992 

0.2864 

8.9928 

0.1967 

9.9912 

0 . 1102 

10.992 

0.0302 

11.9928 

-0.0423 

12 .9912 

-0.1053 

13.992 

-0.1573 

14.9928 

-0.1991 

15.9912 

-0.2295 

16.992 

-0.2483 

17.9928 

-0.2584 

18 .9912 

-0.2647 

19.992 

-0.2727 

20.9928 

-0.2858 

21.9912 

-0.3036 

22 .992 

-0.3236 

23.9928 

-0.3428 

24 .9912 

-0.2356 

Figure  A5.  Example  individual  time  series  water-level  forcing  file 
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An  example  wind  forcing  file  is  shown  in  Figure  A6.  The  duration  of  the 
wind  forcing  is  22  hr  and  oscillates  between  90  (blowing  from  the  east)  and 
270  deg  (blowing  from  the  west).  Wind  speed  ranges  from  0  to  8.6  m/s. 


(770 

0T0 

7TT70 

1.0 

1.0 

90.0 

2.0 

2.0 

90.0 

3.0 

2.5 

90.0 

4.0 

3.0 

90.0 

5.0 

3.5 

270.0 

6.0 

4.0 

270.0 

7.0 

4.5 

270.0 

8.0 

5.0 

270.0 

9.0 

5.5 

270.0 

10.0 

5.8 

270.0 

11.0 

6.0 

270.0 

12.0 

6.5 

270.0 

13.0 

6.8 

270.0 

14.0 

7.0 

270.0 

15.0 

7.0 

270.0 

16.0 

5.0 

270.0 

17 . 0 

2.5 

270.0 

18.0 

0.0 

90.0 

19.0 

2.5 

90.0 

20.0 

5.0 

90.0 

21.0 

7.0 

90.0 

22.0 

8.6 

90.0 

Figure  A6.  Example  time  series  wind  forcing  file 

An  example  tidal-constituents  forcing  file  is  shown  in  Figure  A7.  The 
constituent  identifiers  (e.g.,  M2”)  are  not  required  in  the  file,  but  remind  the 

user  of  the  order  of  the  constituents. 


US  Naval 

Academy,  Annapolis,  MD  Tidal  Constituents 

0.1344 

147.20 

M2 

0.0226 

175.00 

S2 

0.0262 

126.00 

N2 

0.0061 

174.5 

K2 

0.0579 

283.30 

Kl 

0.0500 

294.10 

01 

0.0037 

130.60 

M4 

o 

o 

o 

o 

M6 

Figure  A7.  Example  tidal-constituents  forcing  file 

An  example  portion  of  an  initial  conditions  file  is  shown  in  Figure  A8.  In 
this  example,  water  levels  are  set  to  non-zero  values,  the  u-  and  v-components  of 
velocity  are  zero,  values  of  dv\  /  dt  are  non-zero,  u f  has  zero  and  non-zero 

values,  and  vf  values  are  zero.  Cell  boundary  types  and  activity  codes  are  also 
written. 


Appendix  A  Example  Input  and  Output  Files 


Figure  A8.  Example  portion  of  an  initial  conditions  file 
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An  example  portion  of  a  radiation-stress  input  file  is  shown  in  Figure  A9. 
Input  of  radiation-stress  gradients  requires  that  they  have  been  previously 
mapped  to  the  CMS-M2D  grid  (SMS  conducts  this  mapping  automatically  in  the 
Steering  Module).  The  x  and  y  components  are  oriented  relative  to  the  CMS- 
M2D  axes.  The  first  line  provides  the  time  stamp.  Second  and  further  lines  up  to 
NCELLS  +  1  provide  the  cell  number,  x  component  of  the  radiation-stress 
gradient,  andy  component  of  the  radiation-stress  gradient.  Sets  of  radiation- 
stress  gradients  for  successive  times  are  included  in  the  same  input  file. 


Tl  IVE: 

0. 000000  1 

1 

8. 

473935E- 005 

-  1.  347822E-  004 

2 

8. 

474045E- 005 

-  1. 349220E- 004 

3 

8. 

474155E- 005 

-  1.  350617E-  004 

4 

8. 

474265E- 005 

-  1. 352014E- 004 

5 

8. 

474375E- 005 

-  1. 353411E- 004 

6 

8. 

474485E- 005 

-  1. 354808E-  004 

7 

8. 

474595E- 005 

-  1.  356205E-  004 

8 

8. 

474705E- 005 

-  1. 357603E- 004 

9 

8. 

474815E- 005 

-  1.  359000E-  004 

o 

1 — 1 

8. 

474925E- 005 

-  1. 360397E- 004 

11 

8. 

475035E- 005 

-  1. 361794E- 004 

12 

8. 

475145E- 005 

-  1. 363191E-  004 

13 

8. 

475255E- 005 

-  1. 364588E-  004 

14 

8. 

475365E- 005 

-  1. 365986E- 004 

15 

8. 

475475E- 005 

-  1. 367383E-  004 

16 

8. 

475585E- 005 

-  1. 368780E-  004 

17 

8. 

475695E- 005 

-  1. 370177E-  004 

18 

8. 

475804E- 005 

-  1.  371574E-  004 

19 

8. 

475915E- 005 

-  1. 372971E-  004 

20 

8. 

476025E- 005 

-  1. 374368E-  004 

21 

8. 

476135E- 005 

-  1.  375766E-  004 

22 

8. 

476245E- 005 

-  1.  377163E-  004 

23 

8. 

476355E- 005 

-  1. 378560E- 004 

24 

8. 

476465E- 005 

-  1.  379957E-  004 

25 

8. 

476575E- 005 

-  1. 381354E-  004 

26 

8. 

476685E- 005 

-  1. 382751E-  004 

27 

8. 

476795E- 005 

-  1. 384148E- 004 

28 

8. 

476905E- 005 

-  1. 385546E-  004 

Figure  A9.  Example  portion  of  radiation-stress  input  file 

An  example  “noerode.dat”  file  is  shown  in  Figure  A10.  The  first  line  gives 
the  number  of  hard-bottom  cells.  The  remaining  lines  list  the  cell  number  of 
each  hard-bottom  cell  followed  by  the  depth  of  the  hard  (non-erodible)  substrate. 


20 

3775  16.000000 
3801  16.000000 

3877  13.000000 

3878  13.000000 

3900  13.000000 

3901  13.000000 

3978  13.000000 

3979  10.000000 

3980  10.000000 

4000  10.000000 

4001  10.000000 

4002  13.000000 

4080  10.000000 

4081  8.000000 

4082  8.000000 

4100  8.000000 

4101  8.000000 

4102  10.000000 

4182  8.000000 

4183  6.000000 


Figure  A10.  Example  noerode.dat  input  file 
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Three  examples  of  the  sedparams.dat  file  are  provided  because  the  fde 
format  is  dependent  on  the  selected  sediment  transport  option.  A  sample 
sedparams.dat  file  for  the  Watanabe  total  load  formulation  is  provided  first, 
followed  by  examples  for  the  Lund-CIRP  total  load  formulation  and  the  AD 
equation,  respectively. 

An  example  sedparams.dat  file  for  the  Watanabe  total  load  formulation 
option  is  provided  in  Figure  All.  The  first  line  contains  a  value  of  1,  which 
informs  CMS-M2D  that  the  Watanabe  total  load  formulation  is  to  be  applied. 
The  remaining  lines  contain  the  input  options  and  parameters  required  by  the 
Watanabe  formulation  and  morphology  change  calculations. 


1 

/*  ISEDFORM 

120.000000 

/*  Transport  Rate  Time  Step  (sec) 

0.250000 

/*  Morphologic  Time  Step  (hrs) 

0.200000 

/*  Particle  Size  (D50)  mm 

2650.000000 

/*  Sediment  Density  (RHOs)  kg/mA3 

1000.000000 

/*  Water  Density  (RHOw)  kg/mA3 

5.000000 

/*  T ransport  Slope  Coefficient 

0.050000 

/*  Critical  Threshold  (THETA) 

0.500000 

/*  Transport  Rate  Coefficient 

0.400000 

/*  Sediment  Porosity 

Figure  A1 1 .  Example  sedparams.dat  input  file  for  Watanabe  total  load 
formulation 

An  example  sedparams.dat  file  for  the  Lund-CIRP  total  load  formulation 
option  is  provided  in  Figure  A12.  The  first  line  contains  a  value  of  2,  which 
informs  CMS-M2D  that  the  Lund-CIRP  total  load  formulation  is  to  be  applied. 
The  remaining  lines  contain  the  input  options  and  parameters  required  by  the 
Lund-CIRP  formulation  and  morphology  change  calculations. 


2 

120.000000 

0.250000 

0.200000 

2650.000000 

1025.000000 

15.000000 

5.000000 

0 

0.400000 

1.000000 

1.000000 


/*  ISEDFORM 

/*  DTSED:  Transport  Rate  Time  Step  (sec) 

/*  DTMORPH:  Morphologic  Time  Step  (hrs) 

/*  D50:  Particle  Size  (D50)  mm 
/*  RHOSED:  Sediment  Density  (RHOs)  kg/mA3 
/*  RHOW:  Water  Density  kg/mA3 
/*  WTEMP:  Water  Temperature  (deg.  C) 

/*  DCOEFF:  Transport  Slope  Coefficient 
/*  IRIPPLE:  Ripples  included  in  calculations 
/*  POROS:  Sediment  Porosity 
/*  SCALEBED:  Bed  Load  Scaling 
/*  SCALESUS:  Suspended  Load  Scaling 


Figure  A12.  Example  sedparams.dat  input  file  for  Lund-CIRP  total  load 
formulation 
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An  example  sedparams.dat  file  for  the  AD  equation  option  is  provided  in 
Figure  A13.  The  first  line  contains  a  value  of  3,  which  informs  CMS-M2D  that 
the  AD  equation  is  to  be  applied.  The  remaining  lines  contain  the  input  options 
and  parameters  required  by  the  AD  equation  and  morphology  change 
calculations.  In  this  example,  a  value  of  3  for  the  suspended  concentration 
profile  denotes  that  the  Lund-CIRP  formulation  will  be  applied.  A  value  of  1  for 
the  suspended  concentration  profile  denotes  that  the  exponential  model  will  be 
applied  and  a  value  of  2  denotes  that  the  van  Rijn  model  will  be  applied. 


3 

120.000000 

0.250000 

0.200000 

2650.000000 

1025.000000 

15.000000 

5.000000 

0 

0.400000 

3 

1.000000 

1.000000 


/*  ISEDFORM 

/*  DTSED:  Transport  Rate  Time  Step  (sec) 

/*  DTMORPH:  Morphologic  Time  Step  (hrs) 

/*  D50:  Particle  Size  (D50)  mm 
/*  RHOSED:  Sediment  Density  (RHOs)  kg/mA3 
/*  RHOW:  Water  Density  kg/mA3 
/*  WTEMP:  Water  Temperature  (deg.  C) 

/*  DCOEFF:  Transport  Slope  Coefficient 
/*  IRIPPLE:  Ripples  included  in  calculations 
/*  POROS:  Sediment  Porosity 
/*  IFUNC:  Suspended  Concentration  Profile 
/*  SCALEBED:  Bed  Load  Scaling 
/*  SCALESUS:  Suspended  Load  Scaling 


Figure  A1 3.  Example  sedparams.dat  input  file  for  AD  equation 


An  example  portion  of  a  time  series  numerical  station  output  file  is  shown  in 
Figure  A 14,  in  which  five  cells  were  selected  for  output.  The  cell  numbers  for 
the  five  cells  are  1,  2,  3,  4,  and  5.  Time  is  elapsed  time  in  days  since  the 
beginning  of  the  simulation. 


TIME 

cl 

c2 

c3 

c4 

c5 

0 . 0000 

-0.1900 

-0.1700 

-0.1500 

-0.1300 

-0.1100 

0 . 0000 

-0.1873 

-0.1700 

-0.1500 

-0.1300 

-0.1100 

0.0003 

-0.1821 

-0.1696 

-0.1500 

-0.1300 

-0.1100 

0 . 0007 

-0.1753 

-0.1683 

-0.1499 

-0.1300 

-0.1100 

0 . 0010 

-0.1675 

-0.1654 

-0.1497 

-0.1300 

-0.1100 

0.0014 

-0.1594 

-0.1606 

-0.1488 

-0.1299 

-0.1100 

0 . 0017 

-0.1515 

-0.1541 

-0 . 1470 

-0.1298 

-0.1100 

0 . 0021 

-0.1439 

-0.1462 

-0.1438 

-0.1292 

-0.1100 

0.0024 

-0.1366 

-0 . 1377 

-0.1389 

-0.1280 

-0.1098 

0.0028 

-0.1295 

-0.1292 

-0.1324 

-0.1259 

-0.1095 

0 . 0031 

-0.1224 

-0.1212 

-0.1245 

-0.1223 

-0.1087 

0 . 0035 

-0.1150 

-0.1138 

-0.1158 

-0.1172 

-0.1072 

0.0038 

-0.1076 

-0.1069 

-0.1071 

-0.1105 

-0 .1047 

0.0042 

-0.1000 

-0.1001 

-0.0988 

-0.1026 

-0.1008 

0 . 0045 

-0.0924 

-0.0931 

-0.0912 

-0.0939 

-0.0954 

0.0049 

-0.0849 

-0.0857 

-0.0842 

-0.0850 

-0.0886 

0.0052 

-0.0776 

-0 . 0781 

-0.0775 

-0.0765 

-0.0806 

0 . 0056 

-0.0703 

-0.0703 

-0.0708 

-0.0688 

-0.0718 

0 . 0059 

-0.0630 

-0.0626 

-0.0637 

-0.0617 

-0.0628 

0.0063 

-0.0556 

-0.0550 

-0.0562 

-0.0550 

-0.0543 

0 . 0066 

-0.0482 

-0.0478 

-0.0483 

-0.0484 

-0.0464 

Figure  A14.  Example  time  series  numerical  station  output  file 
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Example  portions  of  global  elevation  and  velocity  files  are  shown  in 
Figures  A15  and  A16,  respectively.  In  these  examples,  the  time  of  the  output 
is  5.6  hr  after  the  beginning  of  the  simulation.  Coordinates  of  cell  positions 
are  given  in  the  first  two  columns  in  order  of  ascending  cell  number.  Cell 
coordinates  are  those  specified  in  the  grid  file  in  the  x-dist  andy-dist  columns 
(grid  not  shown  for  these  global  output  examples).  Water  level  is  given  in  meters 
(third  column),  following  cell  coordinates;  x-  and  y-components  of  velocity  are 
given  in  meters  per  second  (third  and  fourth  columns,  respectively).  If  multiple 
times  of  global  values  are  written,  they  are  successively  appended  at  the  end  of 
the  file  with  no  lines  between  snapshots.  Global  depth  files  have  the  same  format 
as  global  elevation  files,  and  global  transport  rate  files  have  the  same  format  as 
global  velocity  files,  thus,  examples  portions  of  global  depth  and  global  transport 
rate  files  are  not  shown. 


Tl  IVE:  5.60000 

3771.  25000 

3833. 75000 

3896. 25000 

3958. 75000 
4021.  25000 

4083. 75000 

4146. 25000 
4208.  75000 

4271. 25000 

4333. 75000 

4396. 25000 
4458.  75000 
4521.  25000 

4583. 75000 

4646. 25000 
4708.  75000 
4771.  25000 

4833. 75000 

4896. 25000 

4958. 75000 
5021.  25000 

5083. 75000 

5146. 25000 

5208. 75000 
5271.  25000 

5333. 75000 

5396. 25000 
5458.  75000 

5521. 25000 

5583. 75000 

5646. 25000 
5708.  75000 
5764.  35010 


2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

2786. 

41040 

0. 

1500 

Figure  A1 5.  Example  global  elevation  output  file 
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Tl  IVE:  5.  60000 

3771.  25000 

2786.  41040 

0.  0000 

-  0.  0104 

3833.  75000 

2786.  41040 

0.  0000 

-  0.  0104 

3896.  25000 

2786.  41040 

0.  0000 

-  0.  0095 

3958.  75000 

2786.  41040 

0.  0000 

-  0.  0118 

4021.  25000 

2786.  41040 

0.  0000 

-  0.  0130 

4083.  75000 

2786.  41040 

0.  0000 

-  0.  0140 

4146.  25000 

2786.  41040 

0.  0000 

-  0.  0145 

4208.  75000 

2786.  41040 

0.  0000 

-  0.  0151 

4271.  25000 

2786.  41040 

0.  0000 

-  0.  0155 

4333.  75000 

2786.  41040 

0.  0000 

-  0.  0159 

4396.  25000 

2786.  41040 

0.  0000 

-  0.  0164 

4458.  75000 

2786.  41040 

0.  0000 

-  0.  0168 

4521.  25000 

2786.  41040 

0.  0000 

-  0.  0172 

4583.  75000 

2786.  41040 

0.  0000 

-  0.  0176 

4646.  25000 

2786.  41040 

0.  0000 

-  0.  0181 

4708.  75000 

2786.  41040 

0.  0000 

-  0.  0186 

4771.  25000 

2786.  41040 

0.  0000 

-  0.  0191 

4833.  75000 

2786.  41040 

0.  0000 

-  0.  0196 

4896.  25000 

2786.  41040 

0.  0000 

-  0.  0201 

4958.  75000 

2786.  41040 

0.  0000 

-  0.  0208 

5021.  25000 

2786.  41040 

0.  0000 

-  0.  0214 

5083.  75000 

2786.  41040 

0.  0000 

-  0.  0222 

5146.  25000 

2786.  41040 

0.  0000 

-  0.  0231 

5208.  75000 

2786.  41040 

0.  0000 

-  0.  0241 

5271.  25000 

2786.  41040 

0.  0000 

-  0.  0252 

5333.  75000 

2786.  41040 

0.  0000 

-  0.  0266 

5396.  25000 

2786.  41040 

0.  0000 

-  0.  0282 

5458.  75000 

2786.  41040 

0.  0000 

-  0.  0302 

5521.  25000 

2786.  41040 

0.  0000 

-  0.  0326 

5583.  75000 

2786.  41040 

0.  0000 

-  0.  0356 

5646.  25000 

2786.  41040 

0.  0000 

-  0.  0394 

5708.  75000 

2786.  41040 

0.  0000 

-  0.  0441 

5764.  35010 

2786.  41040 

0.  0000 

-  0.  0493 

Figure  A1 6.  Example  global  velocity  output  file 
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Appendix  C 
Slosh  Tests 


This  appendix  describes  the  performance  of  CMS-M2D  for  slosh  tests.  This 
set  of  numerical  integrity  tests  evaluates  mass  conservation  and  numerical 
damping  properties  of  the  model.  Approximations  to  the  full  equations  of  motion 
truncate  terms  to  some  order  in  a  manner  that  depends  on  the  numerical  solution 
method.  Truncation  of  terms  is  known  to  introduce  numerical  viscosity  (Roache 
1976), 1  which  is  manifested  as  damping  of  a  signal.  The  slosh  test  provides  a 
means  of  examining  the  damping  properties  of  numerical  computation  methods. 
In  a  slosh  test,  the  initial  condition  of  a  tilted  water  surface  is  imposed,  and  the 
basin  is  allowed  to  freely  propagate  the  resulting  wave  through  reflection  at  both 
ends.  External  forcing  and  bottom  frictional  stress  are  set  to  zero  so  that  there  is 
no  masking  of  the  free-surface  oscillations.  Time-series  of  water  elevation  over 
the  duration  of  the  simulation  exhibit  model  damping  properties.  Tests  described 
here  were  patterned  after  those  by  Cialone  (1989). 

The  slosh  test  was  performed  to  examine  damping  properties  and  mass 
conservation  for  two  grid  configurations.  Both  grid  configurations  were 
rectangular,  with  the  grid  being  longer  parallel  to  the  x-axis  than  parallel  to  the  y- 
axis.  A  test  consisted  of  applying  a  tilted  water  surface  as  the  initial  condition, 
where  the  direction  of  tilt  was  parallel  to  the  x-axis.  The  initial  deviation  from 
still- water  depth  was  symmetric  about  the  channel  center  and  increased  or 
decreased  sinusoidally  along  the  main  channel  axis  (Figure  Cl). 

No  variation  in  water  level  was  specified  across  the  width  (parallel  to  the  y- 
axis)  of  the  channel.  Initial  current  velocity  was  set  to  zero,  and  no  boundary 
forcing,  bottom  friction,  or  wind  stress  was  applied.  The  Coriolis  term  and 
lateral  mixing  were  set  to  zero.  Simulation  duration  was  set  to  30  days  (720  hr) 
and  the  time  step  was  set  to  5  s.  General  grid  configurations  and  inclusion  of 
advective  terms  are  given  in  Table  Cl.  Conducting  identical  tests  with  and 
without  inclusion  of  the  advective  terms  allows  isolation  of  their  contribution  to 
damping  and  mass  conservation. 


1  References  cited  in  this  appendix  are  included  in  the  References  section  at  the  end  of  the  main  text 
of  this  report. 
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Figure  Cl .  Slosh  test  initial  condition 


Table  Cl 

Slosh  Test  Configurations 

Test 

Bottom 

Advection 

1 

Flat 

No 

2 

Flat 

Yes 

3 

Sloped 

No 

4 

Sloped 

Yes 

Mass  conservation  was  calculated  as  percent  change  in  water  volume  over 
the  numerical  grid  between  time  t  =  0  and  the  end  of  the  simulation  period. 
Percent  change  in  water  volume  A¥~  was  calculated  as: 


^  n  n  ^ 


%AV-  — 100 


1=1_ i= i 


V  i= i  y 


(Cl) 


where  is  the  final  volume,  ¥~ic  is  the  initial  volume,  the  subscript  i  indicates 
cell  number,  and  n  is  the  total  number  of  cells  in  the  grid. 


Tests  1  and  2  were  conducted  to  evaluate  damping  and  mass  conservation  of 
the  model  for  a  flat-bottomed,  constant-spaced  grid,  with  and  without  the 
advective  terms  included  in  the  calculations,  respectively.  Grid  configurations 
and  numerical  parameters  for  Tests  1  and  2  are  given  in  Table  C2,  and  the  grid  is 


C2 
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shown  in  Figure  C2.  Tests  1  and  2  resulted  in  5  x  10'6  and  1  x  10"5  percent 
changes  in  volume,  respectively. 


Table  C2 

Slosh  Test  Grid  Configurations  and  Numerical  Parameters  for 

Tests  1  and  2 

Numerical  Parameter 

Value 

As,  m 

500 

Af,  s 

5 

h,  m 

10 

Length,  m 

10,000 

Width,  m 

2,500 

L  =  10,000  m 


500  m 

x 


Figure  C2.  Computational  grid  for  Tests  1  and  2 


Damping  properties  for  Tests  1  and  2  are  shown  by  time  series  of  water  level 
in  Figures  C3  and  C4,  respectively.  Water  levels  shown  for  each  plot  were  taken 
0.5  Ax  from  the  boundary  and  centered  with  respect  to  channel  width.  Time 
series  shown  for  all  other  tests  are  also  taken  at  the  same  cell.  Axis  breaks 
(x-axis)  were  inserted  into  the  plots  so  that  time  series  at  the  beginning  and 
ending  portions  of  the  simulations  could  be  easily  viewed.  Test  1  does  not 
exhibit  damping  over  the  duration  of  the  simulation.  Weak  nonlinear  motion 
owes  to  the  nonlinear  form  of  the  continuity  equation.  Test  2  exhibits  weak 
damping  over  the  1 -month  simulation.  Development  of  nonlinearities  is  slightly 
stronger  than  for  Test  1  owing  to  the  contribution  by  the  advective  terms.  Tests  1 
and  2  were  repeated  with  an  initial  surface  deviation  10  times  smaller  than 
described  here  (results  not  shown).  Motion  induced  by  this  smaller  water- surface 
deviation  was  not  sufficient  to  develop  nonlinearities  and  the  resulting  slosh 
motion  for  both  cases  (with  and  without  advection)  showed  no  variation  in  peak 
water  level,  and  no  damping  was  exhibited. 
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The  fundamental  seiche  period  for  a  rectangular  basin  is  given  by: 


where  /  is  the  length  of  the  basin.  For  a  wave  traveling  parallel  to  the  x-axis  of 
the  slosh-test  grid,  T=  0.02337  day,  corresponding  to  a  frequency  of 
42.8  cycles/day  (cpd).  Spectrums  of  water  levels  shown  in  Figures  C3  and  C4 
for  Tests  1  and  2  are  displayed  in  Figures  C5  and  C6,  respectively.  Peak 
amplitudes  occur  at  42.8  cpd.  Small  peaks  (slightly  visible  in  Figures  C5  and 
C6)  are  contained  in  the  spectra  at  85.6  cpd,  indicating  the  presence  of  a  weak 
harmonic  of  the  primary  seiche  frequency.  These  tests  indicate  that  the 
discretized  equations  applied  for  calculation  of  water  level  in  Tests  1  and  2  do 
not  introduce  erroneous  frequencies  into  the  solution. 


Figure  C3.  Time  series  of  water  level  for  Test  1 


Figure  C4.  Time  series  of  water  level  for  Test  2 
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Figure  C5.  Spectrum  of  water  level  for  Test  1 
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Figure  C6.  Spectrum  of  water  level  for  Test  2 


Tests  3  and  4  were  designed  to  determine  how  damping  and  mass 
conservation  properties  respond  to  a  grid  with  sloped  bottom  and  constant  cell 
sizes.  Grid  configurations  and  numerical  parameters  for  Tests  3  and  4  are  given 
in  Table  C3  and  the  grid  is  shown  in  Figure  C7.  Changes  in  volume  of  5  x  10'6 
and  1  x  10"5  percent  were  calculated  for  Tests  3  and  4,  respectively. 
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Table  C3 

Slosh  Test  Grid  Configurations  and  Numerical  Parameters  for 

Tests  3  and  4 

Numerical  Parameter 

Value 

As,  m 

500 

Af,  s 

5 

h,  m 

Min  =  9  m,  Max  =  11  m,  Ah  /Ax  =  0.0002 

Length,  m 

10,000 

Width,  m 

2,500 

Damping  properties  for  Tests  3  and  4  are  shown  by  time  series  of  water  level 
in  Figures  C8  and  C9,  respectively.  Starting  maximum  water  level  for  both  tests 
was  0.01  m  at  0.5Ax  from  the  end  of  the  grid.  Test  3  does  not  exhibit  damping 
over  the  duration  of  the  simulation.  Water  levels  from  Test  4  are  slightly  damped 
by  properties  of  the  numerical  algorithm  for  the  advective  terms.  In  both  tests, 
water  levels  are  weakly  nonlinear,  as  described  for  Tests  1  and  2. 

Spectrums  of  water  levels  for  Tests  3  and  4  are  displayed  in  Figures  CIO  and 
Cl  1,  respectively.  Peak  amplitudes  occur  at  42.4  cpd.  Small  peaks  (slightly 
visible  in  Figures  C5  and  C6)  are  contained  in  the  spectra  at  84.8  cpd,  indicating 
the  presence  of  a  weak  harmonic  of  the  primary  seiche  frequency.  These  spectra 
demonstrate  that  the  discretized  equations  applied  for  calculation  of  water  level 
in  Tests  3  and  4  do  not  introduce  erroneous  frequencies  into  the  solution. 
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Figure  C8.  Time  series  of  water  level  for  Test  3 


Figure  C9.  Time  series  of  water  level  for  Test  4 


Appendix  C  Slosh  Tests 


C7 


Figure  CIO.  Spectrum  of  water  level  for  Test  3 


Figure  Cl  1 .  Spectrum  of  water  level  for  Test  4 
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Appendix  D 
Wind  Set  Up  Tests 


This  appendix  describes  tests  designed  to  evaluate  model  performance  under 
wind  forcing.  Two  tests  were  performed  to  examine  model  response.  The  first 
test  compares  the  results  of  numerical  calculations  to  those  of  an  analytical 
solution  for  a  rectangular  channel.  The  second  test  evaluates  model  response  to 
wind  forcing  in  a  basin  of  arbitrary  shape. 

Wind  set  up  in  a  rectangular  channel  for  steady-state  conditions  is  maintained 
by  a  balance  of  the  pressure  gradient,  wind  forcing,  and  bottom  friction.  For  ID 
flow,  the  momentum  equation  (Equation  2)  can  be  reduced  to  (Bretschneider 
1966)2: 


dr\_  (tu.  +  t/;) 
dx  p  wg{h  +  r|) 


(Dl) 


where  Tw  is  the  wind  stress,  and  \b  is  the  bottom  stress.  In  the  absence  of 
bottom  friction,  Equation  Dl  of  Bretschneider  can  be  rewritten  as: 


dr ]_  kET2 
dx  g(h  +  T|) 


(D2) 


where  k  =  3.3  x  10“6 .  The  coefficient  k  was  derived  from  wind  and  bottom-stress 
coefficients  determined  in  a  study  of  Lake  Okeechobee,  FL  (Saville  1953). 
Application  of  Equation  D2  to  the  present  study  required  modification  of  K  to  be 
equal  to  the  wind-stress  coefficient  applied  in  CMS-M2D,  which  varies  with 
wind  speed,  so  that  analytical  and  numerical  solutions  could  be  compared. 
Integration  of  Equation  D2  gives: 


kW2 

r|  =  j2 - ( x  +  C)  +  h2-h  (D3) 

where  C  is  a  constant  of  integration  that  is  determined  by  the  position  of  the 
channel  origin  if  no  bottom  is  exposed,  and  by  the  position  of  the  water-land 
interface  if  drying  has  occurred.  The  parabolic  form  of  Equation  D3  indicates  a 


2  All  references  cited  in  this  appendix  are  included  in  the  References  section  at  the  end  of  the  main 
text. 
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locally  wind-forced  water  surface  in  a  rectangular  channel  does  not  have  a  linear 
distribution  along  the  channel  axis.  Instead,  the  water  surface  will  be  curved, 
with  the  curvature  being  dependent  on  the  channel  length  and  depth,  and  the 
wind  speed. 

For  comparison  of  the  analytical  and  numerical  solutions  of  Equation  D2,  a 
ID  grid  was  developed  that  had  a  total  length  of  9,500  m  and  was  95  cells  long. 
Each  square  cell  had  side  dimensions  of  100  m.  The  still-water  depth  was  set  to 
2  m  and  the  time  step  was  10  s.  The  wind  speed  set  to  10  m/s  and  held  constant. 

A  10-m/s  wind  speed  corresponds  to  K  =  1.9375  x  10-6 .  Figure  D1  compares 
water  level  computed  analytically  from  Equation  D2  and  numerically  by  CMS- 
M2D,  under  steady-state  conditions.  The  numerical  solution  well  reproduces  the 
steady-state,  wind-induced  set  up  and  set  down  of  the  analytical  solution  for 
simulations  applied  to  shallow  water. 


Distance,  m 


Figure  D1 .  Comparison  of  analytical  and  numerical  solutions  of  steady-state, 
wind-induced  set  up,  no  exposed  channel  bottom 

To  test  the  response  of  the  model  to  wind  forcing  in  a  basin  of  arbitrary 
geometry,  a  modified  version  of  the  hourglass  test  developed  for  a  curvilinear 
grid  (Spaulding  1984)  was  examined.  An  hourglass-shaped  grid  was  developed 
with  constant  cell-side  lengths  set  to  500  m  and  an  ambient  depth  of  5  m.  The 
time  step  was  set  to  30  s.  Two  tests  were  performed,  one  for  wind  blowing  from 
the  west  (from  the  negative  x-axis)  and  the  other  for  wind  blowing  from  the  north 
(from  the  positive  y-axis).  For  each  test,  the  wind  was  ramped  up  over  a  24-hr 
interval  and  held  constant  at  10  m/s  for  the  remainder  of  the  100-hr  simulation. 

Water-surface  elevation  for  the  west  wind  test  is  shown  in  Figure  D2.  The 
set  up  and  set  down  are  symmetric  between  the  upper  and  lower  portions  of  the 
grid.  The  water-surface  elevation  contours  for  the  north  wind  test  are  shown  in 
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Figure  D3.  The  water-surface  elevation  for  the  north  wind  test  is  equally 
distributed  between  the  left  and  right  portions  of  the  grid.  Symmetry  in  both  tests 
demonstrates  that  there  is  no  inconsistency  in  calculations  at  wall  boundaries. 

The  results  of  this  test  demonstrate  that  the  model  responds  to  wind  forcing  with 
qualitatively  correct  patterns  of  water-surface  deviation.  Wind  set  up  calculated 
by  CMS-M2D  is  qualitatively  similar  to  results  displayed  graphically  by 
Spaulding  (1984)  and  by  Cialone  (1989). 
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Figure  D3.  Water-surface  elevation  contours  for  north  wind 
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Appendix  E 
Advection  Test 


Advective  terms  were  examined  by  developing  a  grid  with  an  idealized 
jettied  inlet  and  displaying  the  current  field  during  ebb  flow.  Inclusion  of  the 
advective  terms  in  the  momentum  equations  allows  the  model  to  properly 
simulate  eddies  and  an  ebb  jet  as  the  ebb  flow  exits  the  inlet.  Eddies  and  jets  will 
not  develop  without  advective  terms  represented  in  the  calculations. 

The  idealized  inlet  grid  was  specified  to  have  a  flat  bottom  with  a  still- water 
depth  of  5  m.  Inlet  dimensions  were  300  m  wide  and  800  m  long.  Cell-side 
lengths  were  25  m  on  all  sides  in  the  inlet  and  nearshore  areas.  Cell  size 
increased  to  50  m  offshore.  The  time  step  was  set  to  1  s.  Water  level  was  forced 
with  a  sine  wave  having  amplitude  of  0.5  m  and  period  of  12.42  hr. 

Two  simulations  were  conducted,  one  without  advective  terms  included  in 
the  computations  and  one  with  them.  Figure  El  shows  the  current  field  from  the 
test  without  the  advective  terms  during  the  ebb  tidal  cycle.  No  eddies  are  present 
and  flow  exiting  the  inlet  spreads  laterally,  but  does  not  form  a  jet.  However, 
with  the  advective  terms  included  in  the  computations  (Figure  E2),  a  well- 
developed  ebb  jet  is  formed  and  eddies  are  present  on  each  side  of  the  jet.  The 
ebb  jet  and  eddies  are  symmetrical  about  the  axis  of  the  inlet,  demonstrating  that 
there  is  no  directional  bias  in  the  advection  algorithm. 
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Figure  El .  Ebb  current  field  for  advection  test,  no  advective  terms 
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Figure  E2.  Ebb  current  field  for  advection  test,  with  advective  terms 
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Appendix  F 

Wetting  and  Drying  Tests 


Tests  were  performed  on  a  sloped-bottom  grid  to  determine  the  stability 
properties  of  the  wetting  and  drying  algorithms.  One-  and  two-dimensional  tests 
were  conducted  to  demonstrate  the  behavior  of  the  flooding  and  drying 
algorithms  under  different  sources  of  hydrodynamic  forcing  and  basin 
geometries.  A  list  and  short  description  of  the  tests  are  given  in  Table  FI. 
Comprehensive  descriptions  and  model  results  are  provided  for  specific  tests. 


Table  FI 

List  and  Description  of  Flooding  and  Drying  Tests 

Test  Number 

Title 

Description 

1 

Channel  with  sloping 
bottom 

Test  wetting  and  drying  of  a  1 D  canal  forced  by  time- 
varying  wind. 

2 

Depression  in  a 
square  grid 

Test  stability  for  wetting  dry  cells  surrounding  a 
ponded  area.  2D  grid. 

Test  1:  Channel  with  Sloping  Bottom 

AID  test  was  conducted  to  examine  the  flooding  and  drying  algorithms  for  a 
channel  with  simple  geometry.  The  test  consisted  of  a  channel  with  a  sloping 
bottom  that  was  forced  by  a  time-varying  wind.  Channel  length  was  150,000  m 
with  101  cells  along  the  main  channel  axis  (parallel  to  the  x-axis)  and  1  grid-cell 
wide.  Cells  were  square  with  side  lengths  of  1,500  m.  The  time  step  was  100  s. 
Channel  bottom  slope  was  1.67  xlO-5  with  maximum  and  minimum  still-water 
depths  of  3  m  and  0.5  m,  respectively.  Forcing  consisted  of  a  wind  that  blew 
along  the  channel  from  the  shallow  end  toward  the  deep  end.  Wind  was  ramped 
up  over  10  hr  to  a  maximum  speed  of  10  m/s  and  held  constant  from  hour  10  to 
hour  100.  Wind  was  turned  off  at  101  hr  and  remained  off  for  the  remainder  of 
the  200-hr  simulation. 

Time  series  of  water  elevation  for  the  sloping-bottom  test  are  shown  in 
Figure  FI  in  10-hr  intervals.  Twenty-six  cells  on  the  shallow  (left)  end  of  the 
grid  are  shown  out  of  101  cells  in  the  grid.  Dry  cells  are  shown  as  white.  When 
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wind  stress  is  applied  to  the  channel  (0  to  100  hr),  water  is  forced  out  of  the 
shallow  area  so  that  successive  drying  of  cells  occurs  from  left  to  right.  A 
maximum  of  21  cells  dried  during  the  simulation.  After  the  wind  was  turned  off 
(hour  101),  water  flowed  from  right  to  left,  successively  inundating  the  dry  cells. 
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Test  2:  Depression  in  Square  Grid 

A  source  of  instability  in  some  flooding  and  drying  algorithms  is  rewetting  of 
dry  cells  that  surround  an  area  that  has  formed  a  pond.  A  robust  flooding 
algorithm  will  remain  stable  with  any  pattern  of  wet  and  dry  cells.  This  test  was 
designed  to  determine  the  behavior  of  the  wetting  and  drying  algorithms  where 
ponding  takes  place. 

A  square  grid  consisting  of  400  50  x  50-m  cells  was  developed  in  which  the 
central  area  contained  a  square  ring  of  shallow  cells  surrounding  deeper  cells 
(Figure  F2).  Outside  the  shallow  ring,  the  depth  was  set  to  2  m  everywhere. 

Cells  in  the  shallow  ring  were  specified  with  depths  of  0.3  m,  with  adjacent 
interior  cells  having  depths  of  0.5  m,  and  adjacent  outer  cells  having  depths  of 
1.0  m.  Four  cells  in  the  center  of  the  depression  were  1-m  deep. 


Figure  F2.  Grid  with  central  depression  surrounded  by  shallow  area 


The  grid  was  forced  with  water-surface  elevation  at  six  cells  located  on  the 
left  side  of  the  grid,  denoted  by  the  red  line  in  Figure  F2.  A  sinusoidal  forcing 
was  applied  having  amplitude  of  1  m  and  period  of  12  hr.  The  depth  at  which 
cells  are  deemed  dry  was  specified  as  0.05  m.  The  model  was  run  for  duration  of 
50  hr,  with  a  ramp  of  1  day  and  time  step  of  5  s.  Plots  of  water  level  and 
circulation  are  shown  in  Figures  F3  through  F10  at  hourly  intervals  starting  at 
hour  42.  During  hours  43  to  47,  the  water  level  was  lowered  to  expose  the  ring 
of  shallow  cells.  The  dry  cells  are  denoted  by  white  with  no  current  vectors.  A 
pond  was  formed  within  the  interior  of  the  ring  of  dry  cells. 
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Water  level  rises  from  hours  45  through  49.  At  hour  46  (Figure  F7),  cells  on 
the  outer  portion  of  the  shallow  ring  (with  ambient  depths  of  1  m)  have  rewetted. 
By  hour  48  (Figure  F9),  all  previously  dry  cells  have  rewetted.  During  the 
process  of  flooding  and  drying,  no  instabilities  were  encountered.  Thus,  the 
wetting  and  drying  algorithms  in  CMS-M2D  function  properly  for  the  situation 
of  flooding  around  a  ponded  area. 


Figure  F3.  Water  level  and  circulation  pattern  at  hour  42 
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Figure  F4.  Water  level  and  circulation  pattern  at  hour  43 


Figure  F5.  Water  level  and  circulation  pattern  at  hour  44 
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Figure  F6.  Water  level  and  circulation  pattern  at  hour  45 
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Figure  F7.  Water  level  and  circulation  pattern  at  hour  46 
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Figure  F8.  Water  level  and  circulation  pattern  at  hour  47 


Figure  F9.  Water  level  and  circulation  pattern  at  hour  48 
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Figure  F10.  Water  level  and  circulation  pattern  at  hour  49 
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Appendix  G 

Wave-Adjusted  Boundary 
Condition  Test 


This  appendix  demonstrates  the  wave-adjusted  boundary  condition  for  an 
idealized  beach.  In  the  example,  wave  forcing  is  applied  to  calculate  a  longshore 
current.  The  wave-adjusted  boundary  condition  modifies  the  water  level  and 
velocity  on  boundaries  forced  by  water-surface  elevation  to  account  for  the 
presence  of  wave  forcing.  Thus,  the  prescribed  boundary  forcing  is  applied  after 
being  adjusted  for  the  presence  of  waves.  This  adjustment  promotes  realistic 
circulation  patterns  and  wave  set  up  and  set  down  at  the  boundaries,  making 
values  at  the  lateral  boundaries  compatible  with  values  calculated  within  the 
calculation  domain  near  the  boundaries.  A  simulation  without  the  wave-adjusted 
boundary  condition  is  also  shown,  which  illustrates  the  necessity  of  the 
modification  of  water  level  and  velocity  at  the  boundary. 

An  idealized  beach  computational  grid  was  developed  (Figure  Gl)  having 
grid  spacing  of  50  m  in  each  horizontal  direction,  and  depths  ranging  from 
1.13  m  at  the  shoreline  to  18.4  m  at  the  seaward  boundary.  CMS-M2D  and 
STWAVE  domains  were  identical  for  the  idealized  beach  simulations. 

Forcing  for  the  models  was  specified  as: 

a.  STWAVE:  Wave  height  of  2.0  m,  period  of  10.0  s,  and  wave  angle  of 
25.0  deg.  Spectral  spreading  parameters  were  y  =  3.3  and  nn  =  4. 

b.  CMS-M2D:  Water-surface  elevation  set  to  0.0  m  along  lateral  and 
seaward  boundaries. 

CMS-M2D  was  run  for  12.5  hr  with  a  2-s  time  step  and  ramp  duration  of 
0.02  day.  Results  from  the  simulation  without  the  wave-adjusted  boundary 
condition  are  described  first,  followed  by  those  with  the  wave-adjusted  boundary 
condition. 
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Figure  G1 .  Computational  grid  for  idealized  beach 


Water-surface  elevation  and  velocity  as  computed  by  the  standard  water- 
surface  elevation  forcing  boundary  condition  (boundaries  not  adjusted  for 
presence  of  wave  forcing)  are  shown  in  Figures  G2  and  G3,  respectively.  Set  up 
is  calculated  at  the  shoreline,  but  decreases  to  zero  at  the  lateral  boundaries.  A 
longshore  current  is  develops  in  the  nearshore  area,  but  velocities  at  the  lateral 
boundaries  are  weaker  than  inside  the  calculation  domain  and  display  unrealistic 
patterns.  The  unrealistic  velocity  patterns  and  water- surface  elevations  at  the 
lateral  boundaries  owe  to  the  absence  of  the  wave  stresses  there. 

Water-surface  elevation  and  velocity  as  computed  by  the  wave-adjusted 
boundary  condition  are  shown  in  Figures  G4  and  G5,  respectively.  Set  up  is 
calculated  at  the  shoreline  and  extends  nearly  uniformly  across  the  entire  grid. 
An  alongshore  current  is  well  developed  in  the  nearshore  area,  both  near  the 
lateral  boundaries  and  away  from  them.  Because  the  boundary  conditions  were 
adjusted  for  the  presence  of  wave  forcing,  the  circulation  patterns  are  realistic. 
Water  can  flow  onto  and  off  of  the  grid  along  the  lateral  boundaries  without 
incompatibility  between  the  boundary  condition  and  interior  hydrodynamic 
processes. 
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Figure  G2.  Water-surface  elevation  calculated  with  standard  water 
surface  elevation  boundary  condition 
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Figure  G3.  Velocity  calculated  with  standard  water-surface  elevation 
boundary  condition 
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Figure  G4.  Water-surface  elevation  calculated  with  wave-adjusted 
boundary  condition 


Figure  G5.  Velocity  calculated  with  wave-adjusted  boundary  condition 
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Appendix  H 

Surf  Zone  Verification  Tests 


To  verify  CMS-M2D’s  response  to  wave  forcing,  calculations  were 
compared  to  laboratory  data  collected  by  Visser  (1982). 3  Because  the  laboratory 
experiments  were  conducted  with  monochromatic  waves  and  the  bathymetry  was 
uniform  alongshore,  CMS-M2D  was  modified  to  include  a  ID  monochromatic 
wave-transformation  model.  This  model  applies  linear  wave  theory  to  compute 
wave  transformation  and  computes  wave  height  of  depth-limited  breaking  and 
broken  waves  by  the  wave  stability  relationship  of  Dally  et  al.  (1985).  It  also 
includes  representation  of  the  wave  roller  as  described  by  Dally  and  Brown 
(1995)  and  Dally  and  Osiecki  (1994).  Water  levels  calculated  by  CMS-M2D  are 
passed  to  the  wave  transformation  model  to  allow  waves  to  respond  to  the  set  up 
and  set  down. 

Larson  and  Kraus  (2002)  provide  succinct  descriptions  of  the  wave  stability 
relationship  and  roller  model  together  with  comparisons  of  calculated  and 
measured  longshore  current,  including  comparisons  to  the  Visser  (1982)  data, 
with  and  without  the  roller  model.  Their  results  demonstrate  that  inclusion  of  the 
roller  momentum  for  calculation  of  the  longshore  current  and  wave  set  up 
increases  accuracy.  Without  the  roller  momentum,  peak  longshore  current  was 
calculated  to  be  seaward  of  the  measured  peak,  whereas  including  the  roller 
shifted  the  peak  toward  the  beach  and  aligned  it  with  the  measured  peak.  This 
adjustment  of  the  cross-shore  distribution  of  the  longshore  current  modified  the 
set  up  with  an  increased  set  up  with  the  roller  as  compared  to  without  it. 

Calculation  of  longshore  current  and  set  up  are  conducted  for  two  of  the 
Visser  (1982)  data  sets,  Cases  4  and  7.  Wave  properties  for  each  case  are  listed 
in  Table  HI,  and  cross-shore  profiles  and  roughness  information  are  listed  in 
Table  H2.  The  major  difference  between  these  two  cases  is  the  bottom 
roughness.  Case  4  was  run  on  a  smooth  concrete  bottom,  whereas  bottom 
roughness  elements  were  introduced  for  Case  7,  with  the  wave  conditions  held  to 
be  the  same  as  much  as  possible.  By  choosing  these  two  tests,  performance  of 
CMS-M2D  in  the  surf  zone  over  a  great  difference  in  bottom  roughness  can  be 
demonstrated. 


3  All  references  cited  in  this  appendix  are  included  in  the  References  section  at  the  end  of  the  main 
text. 
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Table  HI 

Wave  Properties  at  Offshore  End  of  Basin  and  Breaker-to-Depth 
Ratio  for  Selected  Visser  (1982)  Laboratory  Experiments 

Case 

Wave  Height,  m 

Wave  Period,  s 

Wave  Angle,  deg 

Breaker  to  Depth 
Ratio 

4 

0.076 

1.02 

19.9 

0.83 

7 

0.078 

1.02 

18.4 

0.74 

Table  H2 

Cross-Shore  Profiles  and  Roughness  Information  for  Selected 
Visser  (1982)  Laboratory  Experiments 

Distance  Across 

Bottom 

Case 

Shore,  m 

Depth,  m 

Beach  Slope1 

Roughness 

4 

-0.472 

-0.040 

0.050 

smooth 

7.328 

0.350 

8.253 

0.350 

7 

-0.472 

-0.040 

0.050 

rough 

7.328 

0.350 

9.503 

0.350 

1  Beach  slope  calculated  for  sloping  portion  of  basin. 

Computational  grids  were  developed  for  each  bathymetric  profile,  and  depths 
were  uniform  alongshore.  For  each  grid,  the  cell  spacing  parallel  to  the 
alongshore  direction  (Ay )  was  0.10  m.  Cell  spacing  parallel  to  the  cross-shore 
direction  ( Ax )  was  0.01  m  from  the  offshore  boundary  to  approximately  1  m 
from  the  shoreline.  Resolution  was  increased  nearer  to  the  shore  to  capture 
details  of  the  set  up  calculation.  As  an  example,  resolution  change  for  the  Case  7 
computational  grid  is  shown  in  Figure  HI. 

Simulations  were  conducted  with  identical  parameter  settings  and  time  step, 
with  the  exception  of  the  Manning  roughness  coefficient  and  the  breaker-to-depth 
ratio  for  which  settings  were  case  dependent.  The  depth  at  which  cells  were 
specified  as  dry  was  0.001  m  and  the  time  step  was  0.025  s.  Breaker-to-depth 
ratios  for  each  case  are  provided  in  Table  HI.  The  Manning  roughness 
coefficient,  serving  as  an  adjustment  parameter,  was  set  to  0.0125  for  Case  4  and 
to  0.022  for  Case  7,  after  numerical  experimentation.  Wave  calculations 
proceeded  shoreward  until  a  minimum  wave  height  of  0.001  m  was  reached. 


Appendix  H  Surf  Zone  Verification  Tests 


Figure  HI .  Detail  of  computational  grid  for  Case  7  showing  cross-shore  variation 
in  cell  spacing 


Comparison  of  measurements  and  calculations  for  wave  height,  longshore 
current  speed,  and  set  up  for  Case  4  are  shown  in  Figures  H2,  H3,  and  H4, 
respectively.  Calculated  wave  height  compared  well  with  measurements,  except 
for  the  maximum  wave  height,  which  was  underestimated  by  the  wave- 
transformation  model.  The  calculated  breakpoint  took  place  directly  shoreward 
and  nearly  at  the  measured  location. 

Calculated  longshore  current  speed  well  reproduced  the  distribution 
determined  by  the  measurements  (Figure  H3).  Peak  current  speeds  compare 
well,  with  the  calculated  peak  located  directly  seaward  of  the  measured  peak. 
Seaward  of  the  breakpoint,  calculated  weakening  of  the  longshore  current  closely 
follows  the  measured  reduction  in  current. 

Set  up  calculations  also  compare  favorably  to  the  measurements  (Figure  H4). 
The  slope  of  the  set  up  is  slightly  reduced  in  the  calculations  as  compared  to 
measurements,  but  the  overall  result  indicates  that  the  model  is  reproducing  the 
wave-induced  set  up. 

Comparison  of  calculated  and  measured  wave  height  and  longshore  current 
speed  for  Case  7  (artificial  roughness)  are  shown  in  Figures  H5  and  H6, 
respectively,  and  calculated  set  up  is  shown  in  Figure  H7  (set  up  measurements 
are  not  available  for  Case  7).  Calculated  peak  wave  height  underpredicts  the 
measured  peak  wave  height.  However,  because  measured  wave  heights  before 
breaking  are  not  available,  there  is  no  indication  of  whether  strong  nonlinear 
shoaling  took  place.  Calculated  longshore  current  speed  closely  matches 
measurements  over  the  peak  and  offshore  reduction  in  speed. 
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Figure  H2.  Wave  height  comparison  for  Case  4 
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Figure  H3.  Longshore  current  comparison  for  Case  4 
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Figure  H4.  Wave-induced  set  up  comparison  for  Case  4 


Figure  H5.  Wave  height  calculated  by  roller  model  for  Case  7 
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Figure  H6.  Longshore  current  calculated  by  M2D  for  Case  7 


Figure  H7.  Wave-induced  set  up  calculated  by  M2D  for  Case  7 


In  conclusion,  calculations  with  CMS-M2D  well  reproduced  the  qualitative 
and  quantitative  features  of  accurate  measurements  of  the  longshore  current  in 
the  laboratory.  This  test  validates  the  overall  equation  solution  scheme  of  the 
model  and  contributions  of  several  terms,  including  the  radiation  stresses,  bottom 
friction,  and  mixing. 
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Appendix  I 
Hard-Bottom  Tests 


Functioning  of  the  hard-bottom  algorithm  within  CMS-M2D  is  demonstrated 
through  two  idealized  tests  that  are  designed  to  show  calculation  properties  of  the 
capability.  Specifically,  demonstrated  properties  are: 

a.  Hard-bottom  cells  do  not  erode  below  the  depth  of  the  non-erodible 
substrate. 

b.  Symmetry  in  depth  change  calculations  for  symmetric  flow  and 
bathymetry. 

c.  Hard-bottom  cells  can  accrete  and  erode  sand  above  the  non-erodible 
substrate. 

d.  Sand  volume  is  conserved. 

Both  tests  applied  the  Watanabe  total  load  sediment  transport  formulation, 
and  sand  size  was  specified  as  0.2  mm. 

Test  1:  Hard-Bottom  Calculations  Under 
Symmetric  Conditions 

Test  1  was  designed  to  demonstrate  that  the  hard-bottom  algorithm  does  not 
allow  erosion  of  hard  substrate,  but  does  allow  accumulation  of  sand  over  the 
non-erodible  surface.  This  example  also  demonstrates  symmetry  of  the 
methodology  and  capability  to  represent  complex  configurations  of  non-erodible 
cells.  The  bathymetric  configuration  (Figure  II)  was  specified  to  be  a  plane 
horizontal  bottom  with  a  pyramid-shaped  shoal  in  the  center.  The  configuration 
was  subject  to  sediment  transport  generated  by  a  constant  and  uniform  current  in 
four  different  simulations  where  the  current  originated  from  each  of  the  four 
sides  of  the  square.  All  simulations  gave  the  same  symmetrical  result  relative  to 
the  main  current  direction,  so  that  results  from  only  one  direction  are  provided. 
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Figure  II .  Model  bathymetry  with  cells  shown 


Figure  12  shows  the  simulation  where  the  current  is  directed  from  the  left 
side.  Because  of  the  presence  of  the  pyramidal  sediment  mound,  the  current 
bends  around  the  structure  as  indicated  in  the  figure.  Under  the  influence  of  the 
current,  the  pyramid  erodes. 

Figure  13  shows  a  magnification  of  the  center  of  the  grid.  Cells  with 
triangles  are  specified  as  having  a  non-erodible  bottom  at  the  initial  cell  depth 
(i.e.,  no  sediment  cover  on  the  hard-bottom  layer).  Two  sets  of  runs  are 
compared.  In  the  first  set,  the  hard  bottom  is  not  in  place,  i.e.,  allowing  the  cells 
to  erode.  In  the  second  set,  the  hard-bottom  cells  are  in  place,  limiting  erosion  to 
a  specified  hard-bottom  depth.  Erosion  below  the  hard-bottom  level  is  allowed 
in  these  cells  during  the  first  set  of  runs,  but  not  during  the  second  set. 

The  result  of  this  comparison  is  shown  in  Figure  14,  displaying  the  change  in 
depth  (blue  denotes  erosion,  and  yellow/red  denote  accretion)  after  7  hr  of 
simulation  with  no  hard-bottom  cells  present  (triangles  are  retained  in  the  image 
for  reference  to  previous  figure).  Cells  specified  as  hard  bottom  in  the  following 
set  of  simulations  erode  in  the  present  simulation,  indicating  that  the 
hydrodynamic  conditions  cause  the  bottom  to  erode  below  the  level  of  the  hard- 
bottom  depth  specified  in  the  following  simulation.  The  depth  change  pattern  is 
symmetric.  Figure  15  shows  the  same  situation,  but  with  the  hard  bottom  in 
place.  The  calculations  show  that  there  is  no  erosion  below  the  hard-bottom 
cells.  Also,  symmetry  is  preserved. 
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Figure  12.  Velocity  field  over  the  schematized  bottom 


Figure  13.  Magnification  of  bathymetry  at  the  center  of  grid.  Cells  with 
triangles  are  specified  as  having  hard  bottom 
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Although  not  shown  here,  other  simulations  with  the  current  originating  from 
the  other  three  sides  of  the  square  gave  the  same  symmetrical  results  relative  to 
the  main  current  direction.  In  all  simulations,  sand  volume  was  conserved. 


Figure  14.  Change  in  depth  after  7  hr  of  simulation  without  hard-bottom 

cells  (triangles  are  left  in  image  for  reference  to  previous  figure). 
Blue  denotes  erosion;  yellow/red  denote  accretion 


Figure  15.  Change  in  depth  after  7  hr  of  simulation  with  hard-bottom  cells. 
Blue  denotes  erosion  and  yellow/red  denote  accretion 
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Test  2:  Erosion  and  Accretion  of  Sand  Over  Hard 
Substrate 


A  computational  grid  was  developed  representing  a  canal  with  a  shallow 
region  located  in  its  center  (Figure  16).  Grid  depths  vary  along  the  x-axis  and  are 
uniform  along  the  y-axis.  In  Figure  16,  cells  having  hard  substrates  are  denoted 
with  triangles.  During  the  simulation,  these  cells  will  erode  to  the  hard-bottom 
surface,  then  undergo  deposition  and  erosion.  The  hard-  bottom  depth  was 
specified  to  be  0.7  m,  and  initial  grid  depths  at  these  cells  were  0.5  m,  meaning 
that  0.2  m  of  sand  covered  the  hard  substrate  at  the  beginning  of  the  simulation. 


Figure  16.  Computational  grid  and  bathymetry  for  demonstration  of  erosion  and 
deposition  of  sand  over  hard  substrate.  Triangles  denote  hard- 
bottom  cells 


A  400-hr  simulation  was  conducted  in  which  the  current  flowed  to  the  right 
(positive)  for  200  hr  and  then  to  the  left  (negative)  for  200  hr,  establishing 
conditions  for  both  erosion  and  deposition  at  the  hard-bottom  cells.  Time  series 
of  current  velocity  and  depth  at  one  hard-bottom  cell  are  shown  in  Figure  17. 
During  the  first  90  hr  of  the  simulation,  scour  of  the  sand  layer  takes  place.  Once 
the  hard-bottom  substrate  is  reached,  scour  ceases  and  the  depth  remains  constant 
at  0.7  m  until  current  velocities  are  weak  enough  for  shoaling  to  start 
(approximately  hour  210).  Sand  accumulates  until  the  current  is  strong  enough 
to  begin  erosion  (approximately  hour  280),  and  the  erosion  continues  until  the 
hard  substrate  is  reached  again.  Thus,  the  hard-bottom  algorithm  functions 
correctly  for  situations  in  which  sand  overlays  the  hard  substrate  and  erosion 
takes  place  to  the  level  of  the  hard  bottom,  and  for  situations  in  which  conditions 
become  depositional  at  hard-bottom  cells. 
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Figure  17.  Time  series  of  depth  of  bottom  and  velocity  for  demonstration  of 
scour  and  accumulation  of  sand  over  hard  substrate 
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